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Classes Hierarch 


Classes 


Represents an authentication request. 


AuthenticationRequest! 


unstable since: 4.1 


Automation Session. 


AutomationSession 


since: 2.18 


List of visited pages. 


BackForwardList 


unstable since: 4.1 


One item of the WebKitBackForwardList. 


BackForwardListItem| 


unstable since: 4.1 


A permission request for reading 


ClipboardPermissionRequest clipboard contents. 
since: 2.42 


A request to open a color chooser. 


ColorChooserRequest! 


unstable since: 4.1 


Represents the context menu in a 
ContextMenu WebKitWebView. 


unstable since: 4.1 


One item of aWebKitContextMenu. 
ontextMenultem| 
unstable since: 4.1 


Defines how to handle cookies in a 


cokieManager WebKitWebContext. 


unstable since: 4.1 


A permission request for accessing user’s 


: — audio/video devices. 
DeviceInfoPermissionRequest 


since: 2.24 


Object used to communicate with the application 
q when downloading. 


unstable since: 4.1 


Web editor state. 
ditorState 
since: 2.10 


Provides access to the icons associated with 
5 web sites. 
aviconDatabase 


unstable since: 4.1 


A request to open a file chooser. 
ileChooserRequest 
unstable since: 4.1 


Controls text search in a WebKitWebView. 
indController| 
unstable since: 4.1 


Represents a form submission request. 
ormSubmissionRequest 
unstable since: 4.1 


Geolocation manager. 
GeolocationManager 
since: 2.26 


A permission request for sharing the user’s location. 
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unstable since: 4.1 
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unstable since: 4.1 


nputMethodContext 


InstallMissingMediaPluginsPermissionRequest 


MediaKeySystemPermissionRequest 


NavigationPolicyDecision 


Notification 


NotificationPermissionRequest 


otionMenu 


lugin 


PointerLockPermissionRequest! 


olicyDecision 


PrintCustomWidget 


rintOperation 


Base class for input method contexts. 


since: 2.28 


Previously, a permission request for installing 
missing media plugins. 


deprecated: 2.40 since: 2.10 


A permission request for using an EME Content 
Decryption Module. 


unstable since: 4.1 
A policy decision for navigation actions. 
unstable since: 4.1 


Holds information about a notification that should 
be shown to the user. 


since: 2.8 


A permission request for displaying 
web notifications. 


since: 2.8 


Represents the dropdown menu of a select 
element in a WebKitWebView. 


since: 2.18 
Represents a plugin, enabling fine-grained control. 
unstable deprecated: 2.32 since: 4.1 

A permission request for locking the pointer. 
since: 2.28 

A pending policy decision. 

unstable since: 4.1 

Allows to embed a custom widget in print dialog. 
deprecated: 2.40 since: 2.16 

Controls a print operation. 


unstable since: 4.1 


A policy decision for resource responses. 
ResponsePolicyDecision 
unstable since: 4.1 


Controls security settings in a 


: WebKitWebContext. 
ecurityManager 


unstable since: 4.1 


Control the behaviour of aWebKitWebView. 
ettings 
unstable since: 4.1 


Represents a URI request. 
equest 
unstable since: 4.1 


Represents an URI response. 


unstable since: 4.1 


Represents a URI scheme request. 
URISchemeRequest 
unstable since: 4.1 


Represents a URI scheme response. 
URISchemeResponse 
unstable since: 4.1 


Handles storage of user content filters on disk. 
UserContentFilterStore 
since: 2.24 


Manages user-defined content which affects 


UserContentManager web pages. 


since: 2.6 


A permission request for accessing user’s 


: — audio/video devices. 
UserMediaPermissionRequest! 


since: 2.8 


Message that can be sent between the UI process 
and web process extensions. 


since: 2.28 


Manages aspects common to all 
WebKitWebViews. 
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ermissionRequest 


Access to the WebKit inspector. 


unstable since: 4.1 


Represents a resource at the end of a URI. 


unstable since: 4.1 


A permission request for accessing website data 
from third-party domains. 


since: 2.30 


Manages data stored locally by web sites. 


since: 2.10 


View specific website policies. 


since: 2.30 


The central class of the WPE WebKit and 
WebKitGTK APIs. 


unstable since: 4.1 
unstable since: 4.1 


Window properties of aWebKitWebView. 


unstable since: 4.1 


A permission request. 


unstable since: 4.1 


Information about an application running in automation mode. 


unstable since: 4.1 


Groups information used for user authentication. 


since: 2.2 


eature 


eatureList 


GeolocationPosition 


nputMethodUnderline 


TPFirstPart 


TPThirdPart 


— 


avascriptResult 


MemoryPressureSettings 


imelInfo 


NavigationAction 


NetworkProxySettings 


ptionMenultem 


Describes a web engine feature that may be toggled at runtime. 


since: 2.42 


Contains a set of toggle-able web engine features. 


since: 2.42 


An opaque struct to provide position updates to a 
WebKitGeolocationManager. 


since: 2.26 


Range of text in an preedit string to be shown underlined. 


since: 2.28 


Describes a first party origin. 


since: 2.30 


Describes a third party origin. 


since: 2.30 


Result of JavaScript evaluation in a web view. 


unstable since: 4.1 


A boxed type representing the settings for the memory pressure handler. 


since: 2.34 


Information about a MIME type. 


unstable since: 4.1 


Provides details about interaction resulting in a resource load. 


unstable since: 4.1 


Configures network proxies. 


since: 2.16 


One item of a WebKitOptionMenu. 


since: 2.18 


ermissionStateQuer 


criptDialog 


criptMessageRepl 


ecurityOrigin 


UserContentFilter| 


UserScript 
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WebViewSessionState 


Enumerations 


AuthenticationScheme 


AutomationBrowsingContextPresentation 


This query represents a user’s choice to allow or deny access to “powerful 


features” of the platform, as specified in the|Permissions W3C 


unstable since: 4.1 
Carries details to be shown in user-facing dialogs. 
unstable since: 4.1 


A reply for a script message received. If no reply has been sent by the 
user, an automatically generated reply with undefined value with be sent. 


since: 2.40 


A security boundary for websites. 


since: 2.16 


A compiled set of rules which applied to resource loads. 


since: 2.24 


A JavaScript snippet which can be injected in loaded pages. 


since: 2.6 


A CSS style sheet which can be injected in loaded pages. 


since: 2.6 


Data stored locally by a web site. 


since: 2.16 


Handles serialization of a web view’s browsing state. 


since: 2.12 


Enum values representing the authentication scheme. 


since: 2.2 


Enum values used for determining the automation 
browsing context presentation. 


since: 2.28 


Enum values used to specify autoplay policies. 
AutoplayPolic 
since: 2.30 


Enum values used for determining the 


achelviodel WebKitWebContext cache model. 


unstable since: 4.1 


Enum values used to denote the stock actions for 


Sntesi Men AGuOn WebKitContextMenulItems. 


unstable since: 4.1 


Enum values used to denote the cookie 


Sale cceniPale acceptance policies. 


unstable since: 4.1 


Enum values used to denote the cookie persistent 


ookiePersistentStorage StOPECTEDES: 


unstable since: 4.1 


Enum values representing the duration for which a 


redentialPersistence credential persists. 


since: 2.2 


Describes the status of aWebKitFeature. 
eatureStatus 
since: 2.42 


Enum values used for determining the hardware 


HardwareAccelerationPolic acceleration policy. 


since: 2.16 


Enum values used to describe the primary purpose of the 
active editable element. 


nputPurpose 


since: 2.28 


Enum values used to denote the different events which 


TnsecureConteuthivent can trigger the detection of insecure content. 


unstable since: 4.1 


oadEvent! 


MediaCaptureState' 


NavigationType 


NetworkProxyMode 


ermissionState 


olicyDecisionType 


rintOperationResponse 


ProcessModel 


aveMode 


: 


ScriptDialogType 


Enum values used to denote the different events that 
happen during a WebKitWebView load operation. 


unstable since: 4.1 


Enum values used to specify the capture state of a 
media device. 


since: 2.34 

Enum values used to denote the various navigation types. 
unstable since: 4.1 

Enum values used to set the network proxy mode. 

since: 2.16 

Enum values representing query permission results. 
since: 2.40 


Enum values used for determining the type of a policy 
decision during 
WebKitWebView: :decide-policy. 


unstable since: 4.1 


Enum values representing the response of the print dialog 
shown with webkit_print_operation_run_dialog(). 


unstable since: 4.1 


Enum values used for determining the 
WebKitWebContext process model. 


deprecated: 2.40 since: 2.4 


Enum values to specify the different ways in which a 
WebKitWebView can save its current web page into a 
self-contained file. 


unstable since: 4.1 


Enum values used for determining the type of 
WebKitScriptDialog. 


unstable since: 4.1 


SnapshotRegion 


TLSErrorsPolic 


UserContentInjectedFrames 


UserScriptInjectionTime 


UserStyleLevel 


WebExtensionMode 


WebProcessTerminationReason 


Bitfields 


Enum values used to specify the region from which to get 
a WebKitWebView snapshot. 


unstable since: 4.1 


Enum values used to denote the TLS errors policy. 


unstable since: 4.1 


Specifies in which frames user style sheets are to be 
inserted in. 


since: 2.6 


Specifies at which place of documents an user script will 
be inserted. 


since: 2.6 


Specifies how to treat an user style sheet. 


since: 2.6 


Enum values used for setting if a WebKitWebView is 
intended for WebExtensions. 


since: 2.38 


Enum values used to specify the reason why the web 
process terminated abnormally. 


since: 2.20 


EditorTyping Attributes 


FindOptions 


HitTestResultContext 


InputHints 


SnapshotOptions 


WebsiteDataTypes 


Error Domains 


Enum values with flags representing typing attributes. 
since: 2.10 

Enum values used to specify search options. 

unstable since: 4.1 


Enum values with flags representing the context of a 
WebKitHitTestResult. 


unstable since: 4.1 


Enum values used to describe hints that might be taken into account by 
input methods. 


since: 2.28 


Enum values used to specify options when taking a snapshot from a 
WebKitWebView. 


unstable since: 4.1 


Enum values with flags representing types of Website data. 


since: 2.16 


Enum values used to denote the various download errors. 
DownloadError 
unstable since: 4.1 


Enum values used to denote the various errors related to the 
: WebKitFaviconDatabase. 
aviconDatabaseError| 


unstable since: 4.1 


Enum values used to denote errors happening when executing JavaScript. 
avascriptError| 
unstable since: 4.1 


Enum values used to denote the various network errors. 
NetworkError 
unstable since: 4.1 


Enum values used to denote the various plugin and media errors. 
luginError 
unstable since: 4.1 


Enum values used to denote the various policy errors. 
olicyError 
unstable since: 4.1 


Enum values used to denote the various print errors. 
rintError 
unstable since: 4.1 


Enum values used to denote errors happening when creating snapshots of 


eS TT WebKitWebView. 


unstable since: 4.1 


Errors that can occur while compiling content filters. 
UserContentFilterError 
since: 2.24 


Enum values used to denote errors happening when sending user messages. 


UserMessageError 
since: 2.28 


Callbacks 


Type definition for a function that will be called back when an URI 
URISchemeReaquesiCallback] request is made for a user registered URI scheme. 


unstable since: 4.1 


Functions 


set_major_version 


get_micro_version 


get_minor_version 


media_key_system_permission_get_name 


uri_for_displa 


user_media_permission_is_ for_audio_device 


user_media_permission_is_for_display_device 


| permission_is_for_video_device 


Function Macros 


Returns the major version number of the 
WebKit library. 


unstable since: 4.1 


Returns the micro version number of the 
WebKit library. 


unstable since: 4.1 


Returns the minor version number of the 
WebKit library. 


unstable since: 4.1 


Get the key system for which access permission is 
being requested. 


since: 2.32 


Use this function to format a URI for display. 


since: 2.24 


Check whether the permission request is for an 
audio device. 


since: 2.8 


Check whether the permission request is for a 
display device. 


since: 2.34 


Check whether the permission request is for a 
video device. 


since: 2.8 
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JRI_LREQUEST 
JRI_LREQUEST_CLASS 
JRILRESPONSE 


JRILRESPONSE_CLASS 
JRILSCHEME_REQUEST 
JRILSCHEME_REQUEST_CLASS 


JRILSCHEME_RESPONSE 


JRILSCHEME_RESPONSE_CLASS 


Constants 


DITING_COMMAND_COPY| 


| 


resi 


DITING_COMMAND_CREATE_LINK' 


DITING_COMMAND_ CUT, 


Check the version of the WebKit headers at 
compilation time. 


unstable since: 4.1 
unstable since: 4.1 


Marks a symbol as deprecated, indicating a replacement. 


unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 


unstable since: 4.1 


The copy clipboard command. Copies the current selection inside a 
WebKitWebView to the clipboard. You can check whether it’s possible to 
execute the command with webkit_web_view_can_execute_editing_command(). 
In general it’s possible to copy to the clipboard when there is an active selection 
inside the WebKitWebView. 


unstable since: 4.1 


The create link command. Creates a link element that is inserted at the current 
cursor position. If there’s a selection, the selected text will be used as the link text, 
otherwise the URL itself will be used. It receives the link URL as argument. This 
command should be executed with 
webkit_web_view_execute_editing_command_with_argument () 


unstable since: 4.1 


The cut clipboard command. Copies the current selection inside a 
WebKitWebView to the clipboard and deletes the selected content. You can 
check whether it’s possible to execute the command with 
webkit_web_view_can_execute_editing_command(). In general it’s possible to 
cut to the clipboard when the WebKitWebView content is editable and there is 
an active selection. 


unstable since: 4.1 


The insert image command. Creates an image element that is inserted at the 
current cursor position. It receives an URI as argument, that is used as the image 
source. This command should be executed 


IEDITING_COMMAND_INSERT_IMAGE) . : : Se : 
with webkit_web_view_execute_editing_command_with_argument(). 


unstable since: 4.1 


The paste clipboard command. Pastes the contents of the clipboard to a 

WebKitWebView. You can check whether it’s possible to execute the command 

with webkit_web_view_can_execute_editing_command(). In general it’s possible 
JEDITING_COMMAND_PASTE to paste from the clipboard when the WebKit WebView content is editable and 
clipboard is not empty. 


unstable since: 4.1 


The paste as plaintext clipboard command. Pastes the contents of the clipboard to 
a WebKitWebView, with formatting removed. You can check whether it’s 
possible to execute the command with 

DITING COMMAND PASTE AS PLAIN TEXT webkit_web_view_can_execute_editing_command(). In general it’s possible to 
= paste from the clipboard when the WebKitWebView content is editable and 
clipboard is not empty. 


unstable since: 4.1 


The redo command. Redoes a previously undone editing command in a 
WebKitWebView. You can check whether it’s possible to execute the command 
EDITING COMMAND REDO with webkit_web_view_can_execute_editing_command(). It’s only possible to 

= = redo a command when it has been previously undone. 


unstable since: 4.1 


The select all command. Selects all the content of the current text field in a 
WebKitWebView. It is always possible to select all text, no matter whether the 
DITING_COMMAND_SELECT_ALL WebKitWebView content is editable or not. You can still check it 

with webkit_web_view_can_execute_editing_command(). 


unstable since: 4.1 


The undo command. Undoes the last editing command in a WebKitWebView. 
You can check whether it’s possible to execute the command with 
webkit_web_view_can_execute_editing_command(). It’s only possible to undo a 
command after a previously executed editing operation. 


DITING_COMMAND_UNDO 


unstable since: 4.1 


Like webkit_get_major_version(), but from the headers used at application 
MAIOR VERSION compile time, rather than from the library linked against at application run time. 


unstable since: 4.1 


Like webkit_get_micro_version(), but from the headers used at application 
MICRO VERSION compile time, rather than from the library linked against at application run time. 


unstable since: 4.1 


Like webkit_get_minor_version(), but from the headers used at application 
MINOR VERSION compile time, rather than from the library linked against at application run time. 


I 


unstable since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Sections 


Bitfields Callbacks 


Dependencies 
Generated by[gi-docgen|2023.3 


Namespace 


WebKit2 - 4.1 


The WebKit library 


Version 2.42.4 
Authors The WebKit GTK and WPE teams 


License BSD, LGPL-2.1 


Website _|https://webkit.org 


Source 


Build 


C headers webkit2/webkit2.h 


pkg-config files webkit2gtk-4.1 


Dependencies 


GObject—2.0 The base type system library 


Browse documentation 


Gio—2.0 GObject Interfaces and Objects, Networking, IPC, and I/O 


Browse documentation 


Gtk—3.0 The GTK widget toolkit 


Browse documentation 


Soup—3.0 HTTP client/server library 


Browse documentation 


Additional documentation 


Classes Hierarch 


Classes 


Represents an authentication request. 


AuthenticationRequest! 


unstable since: 4.1 


Automation Session. 


AutomationSession 


since: 2.18 


List of visited pages. 


BackForwardList 


unstable since: 4.1 


One item of the WebKitBackForwardList. 


BackForwardListItem| 


unstable since: 4.1 


A permission request for reading 


ClipboardPermissionRequest clipboard contents. 
since: 2.42 


A request to open a color chooser. 


ColorChooserRequest! 


unstable since: 4.1 


Represents the context menu in a 
ContextMenu WebKitWebView. 


unstable since: 4.1 


One item of aWebKitContextMenu. 
ontextMenultem| 
unstable since: 4.1 


Defines how to handle cookies in a 


cokieManager WebKitWebContext. 


unstable since: 4.1 


A permission request for accessing user’s 


: — audio/video devices. 
DeviceInfoPermissionRequest 


since: 2.24 


Object used to communicate with the application 
q when downloading. 


unstable since: 4.1 


Web editor state. 
ditorState 
since: 2.10 


Provides access to the icons associated with 
5 web sites. 
aviconDatabase 


unstable since: 4.1 


A request to open a file chooser. 
ileChooserRequest 
unstable since: 4.1 


Controls text search in a WebKitWebView. 
indController| 
unstable since: 4.1 


Represents a form submission request. 
ormSubmissionRequest 
unstable since: 4.1 


Geolocation manager. 
GeolocationManager 
since: 2.26 


A permission request for sharing the user’s location. 
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GeolocationPermissionRequest 
unstable since: 4.1 
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nputMethodContext 


InstallMissingMediaPluginsPermissionRequest 


MediaKeySystemPermissionRequest 


NavigationPolicyDecision 


Notification 


NotificationPermissionRequest 


otionMenu 


lugin 


PointerLockPermissionRequest! 


olicyDecision 


PrintCustomWidget 


rintOperation 


Base class for input method contexts. 


since: 2.28 


Previously, a permission request for installing 
missing media plugins. 


deprecated: 2.40 since: 2.10 


A permission request for using an EME Content 
Decryption Module. 


unstable since: 4.1 
A policy decision for navigation actions. 
unstable since: 4.1 


Holds information about a notification that should 
be shown to the user. 


since: 2.8 


A permission request for displaying 
web notifications. 


since: 2.8 


Represents the dropdown menu of a select 
element in a WebKitWebView. 


since: 2.18 
Represents a plugin, enabling fine-grained control. 
unstable deprecated: 2.32 since: 4.1 

A permission request for locking the pointer. 
since: 2.28 

A pending policy decision. 

unstable since: 4.1 

Allows to embed a custom widget in print dialog. 
deprecated: 2.40 since: 2.16 

Controls a print operation. 


unstable since: 4.1 


A policy decision for resource responses. 
ResponsePolicyDecision 
unstable since: 4.1 


Controls security settings in a 


: WebKitWebContext. 
ecurityManager 


unstable since: 4.1 


Control the behaviour of aWebKitWebView. 
ettings 
unstable since: 4.1 


Represents a URI request. 
equest 
unstable since: 4.1 


Represents an URI response. 


unstable since: 4.1 


Represents a URI scheme request. 
URISchemeRequest 
unstable since: 4.1 


Represents a URI scheme response. 
URISchemeResponse 
unstable since: 4.1 


Handles storage of user content filters on disk. 
UserContentFilterStore 
since: 2.24 


Manages user-defined content which affects 


UserContentManager web pages. 


since: 2.6 


A permission request for accessing user’s 


: — audio/video devices. 
UserMediaPermissionRequest! 


since: 2.8 


Message that can be sent between the UI process 
and web process extensions. 


since: 2.28 


Manages aspects common to all 
WebKitWebViews. 
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ermissionRequest 


Access to the WebKit inspector. 


unstable since: 4.1 


Represents a resource at the end of a URI. 


unstable since: 4.1 


A permission request for accessing website data 
from third-party domains. 


since: 2.30 


Manages data stored locally by web sites. 


since: 2.10 


View specific website policies. 


since: 2.30 


The central class of the WPE WebKit and 
WebKitGTK APIs. 


unstable since: 4.1 
unstable since: 4.1 


Window properties of aWebKitWebView. 


unstable since: 4.1 


A permission request. 


unstable since: 4.1 


Information about an application running in automation mode. 


unstable since: 4.1 


Groups information used for user authentication. 


since: 2.2 


eature 


eatureList 


GeolocationPosition 


nputMethodUnderline 


TPFirstPart 


TPThirdPart 


— 


avascriptResult 


MemoryPressureSettings 


imelInfo 


NavigationAction 


NetworkProxySettings 


ptionMenultem 


Describes a web engine feature that may be toggled at runtime. 


since: 2.42 


Contains a set of toggle-able web engine features. 


since: 2.42 


An opaque struct to provide position updates to a 
WebKitGeolocationManager. 


since: 2.26 


Range of text in an preedit string to be shown underlined. 


since: 2.28 


Describes a first party origin. 


since: 2.30 


Describes a third party origin. 


since: 2.30 


Result of JavaScript evaluation in a web view. 


unstable since: 4.1 


A boxed type representing the settings for the memory pressure handler. 


since: 2.34 


Information about a MIME type. 


unstable since: 4.1 


Provides details about interaction resulting in a resource load. 


unstable since: 4.1 


Configures network proxies. 


since: 2.16 


One item of a WebKitOptionMenu. 


since: 2.18 


ermissionStateQuer 
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criptMessageRepl 


ecurityOrigin 


UserContentFilter| 


UserScript 
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WebViewSessionState 


Enumerations 


AuthenticationScheme 


AutomationBrowsingContextPresentation 


This query represents a user’s choice to allow or deny access to “powerful 


features” of the platform, as specified in the|Permissions W3C 


unstable since: 4.1 
Carries details to be shown in user-facing dialogs. 
unstable since: 4.1 


A reply for a script message received. If no reply has been sent by the 
user, an automatically generated reply with undefined value with be sent. 


since: 2.40 


A security boundary for websites. 


since: 2.16 


A compiled set of rules which applied to resource loads. 


since: 2.24 


A JavaScript snippet which can be injected in loaded pages. 


since: 2.6 


A CSS style sheet which can be injected in loaded pages. 


since: 2.6 


Data stored locally by a web site. 


since: 2.16 


Handles serialization of a web view’s browsing state. 


since: 2.12 


Enum values representing the authentication scheme. 


since: 2.2 


Enum values used for determining the automation 
browsing context presentation. 


since: 2.28 


Enum values used to specify autoplay policies. 
AutoplayPolic 
since: 2.30 


Enum values used for determining the 


achelviodel WebKitWebContext cache model. 


unstable since: 4.1 


Enum values used to denote the stock actions for 


Sntesi Men AGuOn WebKitContextMenulItems. 


unstable since: 4.1 


Enum values used to denote the cookie 


Sale cceniPale acceptance policies. 


unstable since: 4.1 


Enum values used to denote the cookie persistent 


ookiePersistentStorage StOPECTEDES: 


unstable since: 4.1 


Enum values representing the duration for which a 


redentialPersistence credential persists. 


since: 2.2 


Describes the status of aWebKitFeature. 
eatureStatus 
since: 2.42 


Enum values used for determining the hardware 


HardwareAccelerationPolic acceleration policy. 


since: 2.16 


Enum values used to describe the primary purpose of the 
active editable element. 


nputPurpose 


since: 2.28 


Enum values used to denote the different events which 


TnsecureConteuthivent can trigger the detection of insecure content. 


unstable since: 4.1 


oadEvent! 


MediaCaptureState' 


NavigationType 


NetworkProxyMode 


ermissionState 


olicyDecisionType 


rintOperationResponse 


ProcessModel 


aveMode 


: 


ScriptDialogType 


Enum values used to denote the different events that 
happen during a WebKitWebView load operation. 


unstable since: 4.1 


Enum values used to specify the capture state of a 
media device. 


since: 2.34 

Enum values used to denote the various navigation types. 
unstable since: 4.1 

Enum values used to set the network proxy mode. 

since: 2.16 

Enum values representing query permission results. 
since: 2.40 


Enum values used for determining the type of a policy 
decision during 
WebKitWebView: :decide-policy. 


unstable since: 4.1 


Enum values representing the response of the print dialog 
shown with webkit_print_operation_run_dialog(). 


unstable since: 4.1 


Enum values used for determining the 
WebKitWebContext process model. 


deprecated: 2.40 since: 2.4 


Enum values to specify the different ways in which a 
WebKitWebView can save its current web page into a 
self-contained file. 


unstable since: 4.1 


Enum values used for determining the type of 
WebKitScriptDialog. 


unstable since: 4.1 


SnapshotRegion 


TLSErrorsPolic 


UserContentInjectedFrames 


UserScriptInjectionTime 


UserStyleLevel 


WebExtensionMode 


WebProcessTerminationReason 


Bitfields 


Enum values used to specify the region from which to get 
a WebKitWebView snapshot. 


unstable since: 4.1 


Enum values used to denote the TLS errors policy. 


unstable since: 4.1 


Specifies in which frames user style sheets are to be 
inserted in. 


since: 2.6 


Specifies at which place of documents an user script will 
be inserted. 


since: 2.6 


Specifies how to treat an user style sheet. 


since: 2.6 


Enum values used for setting if a WebKitWebView is 
intended for WebExtensions. 


since: 2.38 


Enum values used to specify the reason why the web 
process terminated abnormally. 


since: 2.20 


EditorTyping Attributes 


FindOptions 


HitTestResultContext 


InputHints 


SnapshotOptions 


WebsiteDataTypes 


Error Domains 


Enum values with flags representing typing attributes. 
since: 2.10 

Enum values used to specify search options. 

unstable since: 4.1 


Enum values with flags representing the context of a 
WebKitHitTestResult. 


unstable since: 4.1 


Enum values used to describe hints that might be taken into account by 
input methods. 


since: 2.28 


Enum values used to specify options when taking a snapshot from a 
WebKitWebView. 


unstable since: 4.1 


Enum values with flags representing types of Website data. 


since: 2.16 


Enum values used to denote the various download errors. 
DownloadError 
unstable since: 4.1 


Enum values used to denote the various errors related to the 
: WebKitFaviconDatabase. 
aviconDatabaseError| 


unstable since: 4.1 


Enum values used to denote errors happening when executing JavaScript. 
avascriptError| 
unstable since: 4.1 


Enum values used to denote the various network errors. 
NetworkError 
unstable since: 4.1 


Enum values used to denote the various plugin and media errors. 
luginError 
unstable since: 4.1 


Enum values used to denote the various policy errors. 
olicyError 
unstable since: 4.1 


Enum values used to denote the various print errors. 
rintError 
unstable since: 4.1 


Enum values used to denote errors happening when creating snapshots of 


eS TT WebKitWebView. 


unstable since: 4.1 


Errors that can occur while compiling content filters. 
UserContentFilterError 
since: 2.24 


Enum values used to denote errors happening when sending user messages. 


UserMessageError 
since: 2.28 


Callbacks 


Type definition for a function that will be called back when an URI 
URISchemeReaquesiCallback] request is made for a user registered URI scheme. 


unstable since: 4.1 


Functions 


set_major_version 


get_micro_version 


get_minor_version 


media_key_system_permission_get_name 


uri_for_displa 


user_media_permission_is_ for_audio_device 


user_media_permission_is_for_display_device 


| permission_is_for_video_device 


Function Macros 


Returns the major version number of the 
WebKit library. 


unstable since: 4.1 


Returns the micro version number of the 
WebKit library. 


unstable since: 4.1 


Returns the minor version number of the 
WebKit library. 


unstable since: 4.1 


Get the key system for which access permission is 
being requested. 


since: 2.32 


Use this function to format a URI for display. 


since: 2.24 


Check whether the permission request is for an 
audio device. 


since: 2.8 


Check whether the permission request is for a 
display device. 


since: 2.34 


Check whether the permission request is for a 
video device. 


since: 2.8 


HECK_VERSION 
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JRI_LREQUEST 
JRI_LREQUEST_CLASS 
JRILRESPONSE 


JRILRESPONSE_CLASS 
JRILSCHEME_REQUEST 
JRILSCHEME_REQUEST_CLASS 


JRILSCHEME_RESPONSE 


JRILSCHEME_RESPONSE_CLASS 


Constants 


DITING_COMMAND_COPY| 


| 


resi 


DITING_COMMAND_CREATE_LINK' 


DITING_COMMAND_ CUT, 


Check the version of the WebKit headers at 
compilation time. 


unstable since: 4.1 
unstable since: 4.1 


Marks a symbol as deprecated, indicating a replacement. 


unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 
unstable since: 4.1 


unstable since: 4.1 


The copy clipboard command. Copies the current selection inside a 
WebKitWebView to the clipboard. You can check whether it’s possible to 
execute the command with webkit_web_view_can_execute_editing_command(). 
In general it’s possible to copy to the clipboard when there is an active selection 
inside the WebKitWebView. 


unstable since: 4.1 


The create link command. Creates a link element that is inserted at the current 
cursor position. If there’s a selection, the selected text will be used as the link text, 
otherwise the URL itself will be used. It receives the link URL as argument. This 
command should be executed with 
webkit_web_view_execute_editing_command_with_argument () 


unstable since: 4.1 


The cut clipboard command. Copies the current selection inside a 
WebKitWebView to the clipboard and deletes the selected content. You can 
check whether it’s possible to execute the command with 
webkit_web_view_can_execute_editing_command(). In general it’s possible to 
cut to the clipboard when the WebKitWebView content is editable and there is 
an active selection. 


unstable since: 4.1 


The insert image command. Creates an image element that is inserted at the 
current cursor position. It receives an URI as argument, that is used as the image 
source. This command should be executed 


IEDITING_COMMAND_INSERT_IMAGE) . : : Se : 
with webkit_web_view_execute_editing_command_with_argument(). 


unstable since: 4.1 


The paste clipboard command. Pastes the contents of the clipboard to a 

WebKitWebView. You can check whether it’s possible to execute the command 

with webkit_web_view_can_execute_editing_command(). In general it’s possible 
JEDITING_COMMAND_PASTE to paste from the clipboard when the WebKit WebView content is editable and 
clipboard is not empty. 


unstable since: 4.1 


The paste as plaintext clipboard command. Pastes the contents of the clipboard to 
a WebKitWebView, with formatting removed. You can check whether it’s 
possible to execute the command with 

DITING COMMAND PASTE AS PLAIN TEXT webkit_web_view_can_execute_editing_command(). In general it’s possible to 
= paste from the clipboard when the WebKitWebView content is editable and 
clipboard is not empty. 


unstable since: 4.1 


The redo command. Redoes a previously undone editing command in a 
WebKitWebView. You can check whether it’s possible to execute the command 
EDITING COMMAND REDO with webkit_web_view_can_execute_editing_command(). It’s only possible to 

= = redo a command when it has been previously undone. 


unstable since: 4.1 


The select all command. Selects all the content of the current text field in a 
WebKitWebView. It is always possible to select all text, no matter whether the 
DITING_COMMAND_SELECT_ALL WebKitWebView content is editable or not. You can still check it 

with webkit_web_view_can_execute_editing_command(). 


unstable since: 4.1 


The undo command. Undoes the last editing command in a WebKitWebView. 
You can check whether it’s possible to execute the command with 
webkit_web_view_can_execute_editing_command(). It’s only possible to undo a 
command after a previously executed editing operation. 


DITING_COMMAND_UNDO 


unstable since: 4.1 


Like webkit_get_major_version(), but from the headers used at application 
MAIOR VERSION compile time, rather than from the library linked against at application run time. 


unstable since: 4.1 


Like webkit_get_micro_version(), but from the headers used at application 
MICRO VERSION compile time, rather than from the library linked against at application run time. 


unstable since: 4.1 


Like webkit_get_minor_version(), but from the headers used at application 
MINOR VERSION compile time, rather than from the library linked against at application run time. 


I 


unstable since: 4.1 
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Type 
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Instance methods 


authenticatefcan_save_credentials|cancel]get_certificate_pin_flags]get_host|get_port 
get_proposed_credential]get_realm}Jget_scheme]get_security_originfis_for_proxy}is_retr 
set_can_save_credentials]set_proposed_credential 


Signals 


Generated by[gi-docgen]2023.3 
Class 


WebKit2AuthenticationRequest 


unstable since: 4.1 


Description 


class WebKit2.AuthenticationRequest : GObject.Object 
{ 


priv: WebKitAuthenticationRequestPrivate* 


} 
Represents an authentication request. 


Whenever a client attempts to load a page protected by HTTP authentication, credentials will need to be 
provided to authorize access. To allow the client to decide how it wishes to handle authentication, WebKit 
will fire a WebKitWebView: : authenticate signal with a WebKitAuthenticationRequest object to 
provide client side authentication support. Credentials are exposed through the WebKitCredential 
object. 


In case the client application does not wish to handle this signal WebKit will provide a default handler. To 
handle authentication asynchronously, simply increase the reference count of the 
WebKitAuthenticationRequest object. 


Available since: 4.1 


Hierarchy 
hierarchy this WebKitAuthenticationRequest ancestor_O0 GObject ancestor_0--this 
Ancestors 


@ GObject 


Instance methods 

[webkit_authentication_request_authenticate] 

Authenticate the WebKitAuthenticationRequest. 

since: 2.2 

[webkit_authentication_request_can_save_credentials] 

Determine whether this WebKitAuthenticationRequest should allow the storage of credentials. 
since: 2.2 

Cancel the authentication challenge. 

since: 2.2 


webkit_authentication_request_get_certificate_pin_flags 


Get the GTlsPasswordF lags of the 
WEBKIT_AUTHENTICATION_SCHEME CLIENT_CERTIFICATE_PIN_REQUESTED 
authentication challenge. 


since: 2.34 

[webkit_authentication_request_get_host] 

Get the host that this authentication challenge is applicable to. 
since: 2.2 


webkit_authentication_request_get_port 


Get the port that this authentication challenge is applicable to. 


since: 2.2 

Get the WebKitCredential of the proposed authentication challenge. 
since: 2.2 

Get the realm that this authentication challenge is applicable to. 

since: 2.2 

Get the authentication scheme of the authentication challenge. 


since: 2.2 


webkit_authentication_request_get_security_origin 


Get the WebKitSecurityOrigin that this authentication challenge is applicable to. 


since: 2.30 


webkit_authentication_request_is_for_proxy 


Determine whether the authentication challenge is associated with a proxy server. 
since: 2.2 
Determine whether this this is a first attempt or a retry for this authentication challenge. 


since: 2.2 


webkit_authentication_request_set_can_save_credentials 


Set whether the authentication method associated with request should allow the storage of credentials. 


since: 2.30 


webkit_authentication_request_set_proposed_credential 


Set the WebKitCredential of the proposed authentication challenge. 


since: 2.30 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 
WebKit2.AuthenticationRequest::authenticated 


This signal is emitted when the user authentication request succeeded. Applications handling their own 
credential storage should connect to this signal to save the credentials. 


since: 2.30 


WebKit2.AuthenticationRequest::cancelled 


This signal is emitted when the user authentication request is cancelled. It allows the application to dismiss 
its authentication dialog in case of page load failure for example. 


since: 2.2 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2AuthenticationRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 


void (* _webkit_reserved2) ( 


void (* _webkit_reserved3) ( 
void 

i 
} 


No description available. 


Class members 


parent_class: 
No description available. 

_webkit_reserved0: void 
No description available. 

_webkit_reservedl: void 
No description available. 

_webkit_reserved2: void 
No description available. 

_webkit_reserved3: void 
No description available. 
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Method 


since: 2.2 


Declaration 


void 

webkit_authentication_request_authenticate ( 
WebKitAuthenticationRequest* request, 
WebKitCredential* credential 

) 


A uthenticationRequestauthenticate 


Description 


Authenticate the WebKitAuthenticationRequest. 


Authenticate the WebKitAuthenticationRequest using the WebKitCredential supplied. To 
continue without credentials, pass NULL as credential. 


Available since: 2.2 


Parameters 


credential 


Type:\(WebKitCredential 


A WebKitCredential, or NULL. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 
WebKit2AuthenticationRequestcan_save_credentials 
since: 2.2 


Declaration 


gboolean 
webkit_authentication_request_can_save_credentials ( 
WebKitAuthenticationRequest* request 


) 


Description |[src] 
Determine whether this WebKitAuthenticationRequest should allow the storage of credentials. 


Determine whether the authentication method associated with this 
WebKitAuthenticationRequest should allow the storage of credentials. This will return FALSE if 
WebKit doesn’t support credential storing, if private browsing is enabled, or if persistent credential 
storage has been disabled in WebKitWebsiteDataManager, unless credentials saving has been 
explicitly enabled with webkit_authentication_request_set_can_save_credentials(). 


Available since: 2.2 


Return value 
Type: gboolean 


TRUE if WebKit can store credentials or FALSE otherwise. 
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Method 


since: 2.2 


Declaration 


void 
webkit_authentication_request_cancel ( 

WebKitAuthenticationRequest* request 
) 


A uthenticationRequestcancel 


Description 


Cancel the authentication challenge. 


This will also cancel the page loading and result ina WebKitWebView: : load-failed signal with a 
WebKitNetworkError of type WEBKIT_NETWORK_ERROR_CANCELLED being emitted. 


Available since: 2.2 
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Method 


since: 2.34 


Declaration 


GTlsPasswordFlags 
webkit_authentication_request_get_certificate_pin_flags ( 
WebKitAuthenticationRequest* request 


) 


A uthenticationRequestget_certificate_pin_flags 


Description 


Get the GTlsPasswordF lags of the 
WEBKIT_AUTHENTICATION_SCHEME CLIENT_CERTIFICATE_PIN_REQUESTED 
authentication challenge. 


Available since: 2.34 


Return value 


Type: GTlsPasswordFlags 


A GTlsPasswordFlags. 
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Method 
WebKit2A uthenticationRequestget_host 
since: 2.2 


Declaration 


const gchar* 

webkit_authentication_request_get_host ( 
WebKitAuthenticationRequest* request 

) 


Description 


Get the host that this authentication challenge is applicable to. 
Available since: 2.2 

Return value 

Type: const gchar* 


The host of request. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Method 
WebKit2AuthenticationRequestget_port 
since: 2.2 


Declaration 


guint 

webkit_authentication_request_get_port ( 
WebKitAuthenticationRequest* request 

) 


Description 


Get the port that this authentication challenge is applicable to. 
Available since: 2.2 

Return value 

Type: guint 


The port of request. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


authenticatefcan_save_credentials{cancel|get_certificate_pin_flags]get_host|get_port 
get_proposed_credential]get_realm}Jget_scheme]get_security_originJis_for_proxy}is_retr 
set_can_save_credentials]set_proposed_credential 


Generated by[gi-docgen|2023.3 
Method 


since: 2.2 


Declaration 


WebKitCredential* 

webkit_authentication_request_get_proposed_credential ( 
WebKitAuthenticationRequest* request 

) 


A uthenticationRequestget_proposed_credential 


Description 


Get the WebKitCredential of the proposed authentication challenge. 


Get the WebKitCredential of the proposed authentication challenge that was stored from a previous 
session. The client can use this directly for authentication or construct their own WebKitCredential. 


Available since: 2.2 


Return value 


Type: |WebKitCredential 


A WebKitCredential encapsulating credential details or NULL if there is no stored credential. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 
WebKit2AuthenticationRequestget_realm 
since: 2.2 


Declaration 


const gchar* 

webkit_authentication_request_get_realm ( 
WebKitAuthenticationRequest* request 

) 


Description 


Get the realm that this authentication challenge is applicable to. 
Available since: 2.2 

Return value 

Type: const gchar* 


The realm of request. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


authenticatefcan_save_credentials{cancel|get_certificate_pin_flags]get_host|get_port 
get_proposed_credential]get_realm}Jget_scheme]get_security_originJis_for_proxy}is_retr 
set_can_save_credentials]set_proposed_credential 


Generated by[gi-docgen|2023.3 


Method 
WebKit2AuthenticationRequestget_scheme 
since: 2.2 


Declaration 


WebKitAuthenticationScheme 

webkit_authentication_request_get_scheme ( 
WebKitAuthenticationRequest* request 

) 


Description |[src] 
Get the authentication scheme of the authentication challenge. 


Available since: 2.2 


Return value 


Type: |WebKitAuthenticationScheme 


The WebKitAuthenticationScheme of request. 
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Method 
WebKit2AuthenticationRequestget_security_origin 
since: 2.30 


Declaration 


WebKitSecurityOrigin* 
webkit_authentication_request_get_security_origin ( 
WebKitAuthenticationRequest* request 


) 


Description 


Get the WebKitSecurityOrigin that this authentication challenge is applicable to. 


Available since: 2.30 


Return value 


Type: |WebKitSecurityOrigin 


A newly created WebKitSecurityOrigin. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 
WebKit2AuthenticationRequestis_for_proxy 
since: 2.2 


Declaration 


gboolean 

webkit_authentication_request_is_for_proxy ( 
WebKitAuthenticationRequest* request 

) 


Description 


Determine whether the authentication challenge is associated with a proxy server. 


Determine whether the authentication challenge is associated with a proxy server rather than an 


“origin” server. 


Available since: 2.2 


Return value 
Type: gboolean 


TRUE if authentication is for a proxy or FALSE otherwise. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


authenticatefcan_save_credentials{cancel|get_certificate_pin_flags]get_host|get_port 
get_proposed_credential]get_realm}Jget_scheme]get_security_originJis_for_proxy}is_retr 
set_can_save_credentials]set_proposed_credential 
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Method 


since: 2.2 


Declaration 


gboolean 

webkit_authentication_request_is_retry ( 
WebKitAuthenticationRequest* request 

) 


A uthenticationRequestis_retry 


Description 

Determine whether this this is a first attempt or a retry for this authentication challenge. 
Available since: 2.2 

Return value 

Type: gboolean 


TRUE if authentication attempt is a retry or FALSE otherwise. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


authenticatefcan_save_credentials{cancel|get_certificate_pin_flags]get_host|get_port 
get_proposed_credential]get_realm}Jget_scheme]get_security_originJis_for_proxy}is_retr 
set_can_save_credentials]set_proposed_credential 
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Method 
WebKit2AuthenticationRequestset_can_save_credentials 
since: 2.30 


Declaration 


void 
webkit_authentication_request_set_can_save_credentials ( 
WebKitAuthenticationRequest* request, 
gboolean enabled 
) 


Description 


Set whether the authentication method associated with request should allow the storage of credentials. 


Set whether the authentication method associated with request should allow the storage of credentials. 
This should be used by applications handling their own credentials storage to indicate that it should be 
supported even when internal credential storage is disabled or unsupported. Note that storing of credentials 
will not be allowed on ephemeral sessions in any case. 


Available since: 2.30 


Parameters 
enabled 
Type: gboolean 


Value to set. 
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Library Version: 2.42.4 
Type 


Methods 


authenticatefcan_save_credentials{cancel|get_certificate_pin_flags]get_host|get_port 
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Method 
WebKit2A uthenticationRequestset_proposed_credential 
since: 2.30 


Declaration 


void 

webkit_authentication_request_set_proposed_credential ( 
WebKitAuthenticationRequest* request, 
WebKitCredential* credential 

) 


Description 


Set the WebKitCredential of the proposed authentication challenge. 


Set the WebKitCredential of the proposed authentication challenge that was stored from a previous 
session. This should only be used by applications handling their own credential storage. (When using the 
default WebKit credential storage, 
webkit_authentication_request_get_proposed_credential () already contains 
previously-stored credentials.) Passing a NULL credential will clear the proposed credential. 


Available since: 2.30 


Parameters 


credential 


Type:\(WebKitCredential 


A WebKitCredential, or NULL. 


The data is owned by the caller of the method. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
‘AuthenticationRequest 


Signals 
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Signal 


since: 2.30 


A uthenticationRequest::authenticated 


Declaration 


void 

authenticated ( 
WebKitAuthenticationRequest* self, 
WebKitCredential* credential, 
gpointer user_data 


) 


Description 


This signal is emitted when the user authentication request succeeded. Applications handling their own 
credential storage should connect to this signal to save the credentials. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.30 


Parameters 


credential 


Type:\WebKitCredential 


The WebKitCredential accepted. 


The data is owned by the caller of the function. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
‘AuthenticationRequest 


Signals 
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Signal 


since: 2.2 


A uthenticationRequest::cancelled 


Declaration 


void 

cancelled ( 
WebKitAuthenticationRequest* self, 
gpointer user_data 


) 


Description 


This signal is emitted when the user authentication request is cancelled. It allows the application to dismiss 
its authentication dialog in case of page load failure for example. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.2 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
‘AutomationSession 


Instance methods 


Properties 
Signals 
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Class 


WebKit2AutomationSession 


since: 2.18 


Description 


class WebKit2.AutomationSession : GObject.Object 
{ 
priv: WebKitAutomationSessionPrivate* 


} 
Automation Session. 


WebkKitAutomationSession represents an automation session of a WebKitWebContext. When a new 
session is requested, a WebKitAutomationSession is created and the signal 
WebKitWebContext::automation-started is emitted with the WebKitAutomationSession as argument. 
Then, the automation client can request the session to create a new WebKitWebView to interact with it. 
When this happens the signal WebKitAutomationSession: :create-—web-—view is emitted. 


Available since: 2.18 


Hierarchy 


hierarchy this WebKitAutomationSession ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 


webkit_automation_session_get_application_info 


Get the the previously set WebKitAutomationSession. 
since: 2.18 
Get the unique identifier of aWebKitAutomationSession. 


since: 2.18 


webkit_automation_session_set_application_info 


Set the application information to session. 
since: 2.18 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.AutomationSession:id 


The session unique identifier. 


since: 2.18 


Signals 


WebKit2.AutomationSession::create-web-view 


This signal is emitted when the automation client requests a new browsing context to interact with it. The 
callback handler should return a WebKitWebView created with 

WebKitWebView: is—controlled-—by-—automation construct property enabled and 
WebKitWebView: automation-presentation-—type construct property set if needed. 


since: 2.18 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2AutomationSessionClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 


Content 


Description 
Hierarch 


e 
e 
@ {Ancestors 
@ |Methods 


Properties 


e 
@ |Signals 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 
WebKit2AutomationSessionget_application_info 
since: 2.18 


Declaration 


WebKitApplicationInfo* 
webkit_automation_session_get_application_info ( 
WebKitAutomationSession* session 


) 


Description |[src] 
Get the the previously set WebKitAutomationSession. 


Get the WebKitAutomationSession previously set 
with webkit_automation_session_set_application_info(). 


Available since: 2.18 


Return value 


Type: |WebKitApplicationInfo 


The WebKitAutomationSession of session, or NULL if no one has been set. 


The data is owned by the instance. 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 
WebKit2A utomationSessionget_id 
since: 2.18 


Declaration 


const char* 
webkit_automation_session_get_id ( 
WebKitAutomationSession* session 


) 


Description 


Get the unique identifier of aWebKitAutomationSession. 


Available since: 2.18 


Gets property |WebKit2.AutomationSession:id 


Return value 
Type: const char* 


The unique identifier of session. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 


since: 2.18 


Declaration 


void 

webkit_automation_session_set_application_info ( 
WebKitAutomationSession* session, 
WebKitApplicationInfo* info 

) 


A utomationSessionset_application_info 


Description 


Set the application information to session. 


This information will be used by the driver service to match the requested capabilities with the actual 
application information. If this information is not provided to the session when a new automation session 
is requested, the creation might fail if the client requested a specific browser name or version. This will 
not have any effect when called after the automation session has been fully created, so this must be called 
in the callback of WebKitWebContext::automation-started signal. 


Available since: 2.18 


Parameters 
info 


Type:\(WebKitApplicationInfo 


A WebKitApplicationInfo. 


The data is owned by the caller of the method. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
‘AutomationSession 


Properties 
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Property 


since: 2.18 


A utomationSessiontid 


Declaration 


property id: utf8 [ read, write, construct-only ] 


Description 


The session unique identifier. 


Type: gchar* 
Available since: 2.18 


Default value NULL 


Getter method |webkit_automation_session_get_id() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


ebKit 
API Version: 4.1 


Library Version: 2.42.4 


Type 
‘AutomationSession 


Signals 


create-web-view 
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Signal 


since: 2.18 


A utomationSessiont:create-web-view 


Declaration 


WebKit 2WebView* 

create_web_view ( 
WebKitAutomationSession* self, 
gpointer user_data 


) 


Description 


This signal is emitted when the automation client requests a new browsing context to interact with it. The 
callback handler should return a WebKitWebView created with 

WebKitWebView: is-controlled-by-—automation construct property enabled and 
WebKitWebView: automation-presentation-—type construct property set if needed. 


If the signal is emitted with “tab” detail, the returned WebKitWebView should be a new web view added 
to a new tab of the current browsing context window. If the signal is emitted with “window” detail, the 
returned WebKitWebView should be a new web view added to a new window. When creating a new 
web view and there’s an active browsing context, the new window or tab shouldn’t be focused. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


The signal can be 


Available since: 2.18 


Return value 


Type: 


A WebKitWebView widget. 


The data is owned by the called function. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
BackForwardList 


Instance methods 


get_back_item|get_back_list|get_back_list_with_limit]get_current_item|get_forward_item 
set_forward_list]get_forward_list_with_limit]get_length}get_nth_item 


Signals 
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Class 


WebKit2BackForwardList 


unstable since: 4.1 


Description 


class WebKit2.BackForwardList : GObject.Object 
{ 


priv: WebKitBackForwardListPrivate* 


} 
List of visited pages. 


WebKitBackForwardList maintains a list of visited pages used to navigate to recent pages. Items are 
inserted in the list in the order they are visited. 


WebKitBackForwardList also maintains the notion of the current item (which is always at index 0), the 
preceding item (which is at index -1), and the following item (which is at index 1). Methods 
webkit_web_view_go_back () and webkit_web_view_go_forward() move the current item 
backward or forward by one. Method webkit_web_view_go_to_back_forward_list_item() 
sets the current item to the specified item. All other methods returning 
WebKitBackForwardListItems do not change the value of the current item, they just return the 
requested item or items. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitBackForwardList ancestor_0 GObject ancestor_0--this 
Ancestors 
@ GObject 


Instance methods 


webkit_back_forward_list_get_back_item 


Returns the item that precedes the current item. 


unstable since: 4.1 


webkit_back_forward_list_get_back_list| 


Obtain the list of items preceding the current one. 


unstable since: 4.1 


webkit_back_forward_list_get_back_list_with_limit 


Obtain a list up to some number of items preceding the current one. 
unstable since: 4.1 
Returns the current item inback_forward_list. 


unstable since: 4.1 


webkit_back_forward_list_get_forward_item 


Returns the item that follows the current item. 


unstable since: 4.1 


webkit_back_forward_list_get_forward_list 


Obtain the list of items following the current one. 


unstable since: 4.1 


webkit_back_forward_list_get_forward_list_with_limit 


Obtain a list up to some number of items following the current one. 
unstable since: 4.1 

Obtain the amount of items in the list. 

unstable since: 4.1 

Returns the item at a given index relative to the current item. 


unstable since: 4.1 


Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 
WebKit2.BackForwardList::changed 


This signal is emitted when back_forward_list changes. This happens when the current item is 
updated, a new item is added or one or more items are removed. Note that both item_added and 
items_removed can NULL when only the current item is updated. Items are only removed when the list 
is cleared or the maximum items limit is reached. 


unstable since: 4.1 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2BackForwardListClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 


void (* _webkit_reservedl) ( 


void (* _webkit_reserved2) ( 


void (* _webkit_reserved3) ( 
void 

i 
} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 


_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 


No description available. 


Content 


o [Desorption] 
© [Hierarchy] 
© [Ancestors 
© [Methods 
e@ 
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BackForwardList 


Methods 


get_back_item|get_back_list|get_back_list_with_limit]get_current_item|get_forward_item 
eet_forward_list]get_forward_list_with_limit]get_length}get_nth_item 
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Method 


WebKit2BackForwardListget_back_item 
Declaration 


WebKitBackForwardListItem* 
webkit_back_forward_list_get_back_item ( 

WebKitBackForwardList* back_forward_list 
) 


Description 


Returns the item that precedes the current item. 


Return value 


Type: |WebKitBackForwardListItem 


The WebKitBackForwardListItem preceding the current item or NULL. 


The data is owned by the instance. 


The return value can be NULL. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 
BackForwardList 


Methods 
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Method 


WebKit2BackForwardListget_back_list 
Declaration 


GList* 
webkit_back_forward_list_get_back_list ( 

WebKitBackForwardList* back_forward_list 
) 


Description 


Obtain the list of items preceding the current one. 


Return value 
Type: A list of WebKitBackForwardListItem* 


A GList of items preceding the current item. 


The caller of the method takes ownership of the data container, but not the data inside it. 
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Library Version: 2.42.4 
Type 
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Method 


WebKit2BackForwardListget_back_list_with_limit 
Declaration 


GList* 
webkit_back_forward_list_get_back_list_with_limit ( 
WebKitBackForwardList* back_forward_list, 
guint limit 


) 


Description 
Obtain a list up to some number of items preceding the current one. 
Parameters 
limit 
Type: guint 


The number of items to retrieve. 


Return value 
Type: A list of WebKitBackForwardListItem* 


A GList of items preceding the current item limited by limit. 


The caller of the method takes ownership of the data container, but not the data inside it. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 
BackForwardList 


Methods 
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eet_forward_list]get_forward_list_with_limit]get_length}get_nth_item 
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Method 


WebKit2BackForwardListget_current_item 
Declaration 


WebKitBackForwardListItem* 
webkit_back_forward_list_get_current_item ( 

WebKitBackForwardList* back_forward_list 
) 


Description 


Returns the current item in back_forward_list. 


Return value 


Type: |WebKitBackForwardListItem 


A WebKitBackForwardListItem or NULL if back_forward_list is empty. 


The data is owned by the instance. 


The return value can be NULL. 
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Type 
BackForwardList 


Methods 
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Method 


WebKit2BackForwardListget_forward_item 
Declaration 


WebKitBackForwardListItem* 
webkit_back_forward_list_get_forward_item ( 

WebKitBackForwardList* back_forward_list 
) 


Description 


Returns the item that follows the current item. 


Return value 


Type: |WebKitBackForwardListItem 


The WebKitBackForwardListItem following the current item or NULL. 


The data is owned by the instance. 


The return value can be NULL. 
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BackForwardList 
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Method 


WebKit2BackForwardListget_forward_list 
Declaration 


GList* 
webkit_back_forward_list_get_forward_list ( 
WebKitBackForwardList* back_forward_list 

) 


Description 


Obtain the list of items following the current one. 


Return value 
Type: A list of WebKitBackForwardListItem* 


A GList of items following the current item. 


The caller of the method takes ownership of the data container, but not the data inside it. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 
BackForwardList 


Methods 
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Method 


WebKit2BackForwardListget_forward_list_with_limit 
Declaration 


GList* 
webkit_back_forward_list_get_forward_list_with_limit ( 
WebKitBackForwardList* back_forward_list, 
guint limit 


) 


Description 
Obtain a list up to some number of items following the current one. 
Parameters 
limit 
Type: guint 


The number of items to retrieve. 


Return value 
Type: A list of WebKitBackForwardListItem* 


A GList of items following the current item limited by limit. 


The caller of the method takes ownership of the data container, but not the data inside it. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 
BackForwardList 


Methods 
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Method 


WebKit2BackForwardListget_length 
Declaration 


guint 

webkit_back_forward_list_get_length ( 
WebKitBackForwardList* back_forward_list 

) 


Description 


Obtain the amount of items in the list. 
Return value 
Type: guint 


The length of back_forward_list. 
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BackForwardList 
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Method 


WebKit2BackForwardListget_nth_item 
Declaration 


WebKitBackForwardListItem* 

webkit_back_forward_list_get_nth_item ( 
WebKitBackForwardList* back_forward_list, 
gint index 


) 


Description 
Returns the item at a given index relative to the current item. 
Parameters 
index 
Type: gint 


The index of the item. 


Return value 


Type: |WebKitBackForwardListItem 


The WebKitBackForwardListItem located at the specified index relative to the current item or 
NULL. 


The data is owned by the instance. 


The return value can be NULL. 
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Type 
BackForwardList 


Signals 
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Signal 


WebKit2BackForwardList::changed 


unstable since: 4.1 


Declaration 


void 

changed ( 
WebKitBackForwardList* self, 
WebKitBackForwardListItem* item_added, 
gpointer items_removed, 
gpointer user_data 


Description 


This signal is emitted when back_forward_list changes. This happens when the current item is 
updated, a new item is added or one or more items are removed. Note that both item_added and 
items_removed can NULL when only the current item is updated. Items are only removed when the list 
is cleared or the maximum items limit is reached. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 
item_added 


Type: \(WebKitBackForwardListItem 


The WebKitBackForwardListItem added or NULL. 


The argument can be NULL. 


The data is owned by the caller of the function. 


items_removed 
Type: gpointer 
A GList of WebKitBackForwardListItems. 


The argument can be NULL. 


The data is owned by the caller of the function. 
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Type 
BackForwardListItem 


Instance methods 


get_title}get_uri 
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Class 


WebKit2BackForwardListItem 


unstable since: 4.1 


Description 


class WebKit2.BackForwardListItem : GObject.InitiallyUnowned 
{ 


priv: WebKitBackForwardListItemPrivate* 


} 
One item of the WebKitBackForwardList. 
A history item is part of the WebKitBackForwardList and consists out of a title and a URI. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitBackForwardListItem ancestor_0 GInitiallyUnowned ancestor_O--this ancestor_1 
GObject ancestor_1--ancestor_0 


Ancestors 


@ GlnitiallyUnowned 
@ GObject 


Instance methods 


webkit_back_forward_list_item_get_original_uri 


Obtain the original URI of the item. 


unstable since: 4.1 


webkit_back_forward_list_item_get_title 


Obtain the title of the item. 


unstable since: 4.1 


webkit_back_forward_list_item_get_uri 


Obtain the URI of the item. 


unstable since: 4.1 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2BackForwardListItemClass { 
GInitiallyUnownedClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 


void (* _webkit_reserved2) ( 


void (* _webkit_reserved3) ( 


void 


No description available. 


Class members 


parent_class: GInitiallyUnownedClass 


No description available. 
_webkit_reserved0: void 
No description available. 
_webkit_reservedl: void 
No description available. 
_webkit_reserved2: void 
No description available. 
_webkit_reserved3: void 
No description available. 


Content 


escription 

ierarch 

ncestors 
Methods 


(* _webkit_reserved0) 


(* _webkit_reservedl1) 


(* _webkit_reserved2) 


(* _webkit_reserved3) 


void 


void 


void 


void 


) 


) 


) 


) 
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Type 
BackForwardListItem 
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Method 


WebKit IB ackForwardListItemget_original_uri 
Declaration 


const gchar* 
webkit_back_forward_list_item_get_original_uri ( 
WebKitBackForwardListItem* list_item 


) 


Description 


Obtain the original URI of the item. 

See also webkit_back_forward_list_item_get_uri(). 
Return value 

Type: const gchar* 


The original URI of 1ist_item or NULL when the original URI is empty. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 
BackForwardListItem 
Methods 
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Method 


WebKit2BackForwardListItemget_title 
Declaration 


const gchar* 
webkit_back_forward_list_item_get_title ( 
WebKitBackForwardListItem* list_item 


) 


Description 


Obtain the title of the item. 

Return value 

Type: const gchar* 

The page title of l1ist_item or NULL when the title is empty. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 
BackForwardListItem 


Methods 
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Method 


WebKit2BackForwardListItemget_uri 
Declaration 


const gchar* 
webkit_back_forward_list_item_get_uri ( 

WebKitBackForwardListItem* list_item 
) 


Description 


Obtain the URI of the item. 


This URI may differ from the original URI if the page was, for example, redirected to a new location. See 
also webkit_back_forward_list_item_get_original_uri(). 


Return value 
Type: const gchar* 


The URI of 1ist_item or NULL when the URI is empty. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


ClipboardPermissionRequest 


Generated by 2023.3 
Class 


WebKit2.ClipboardPermissionRequest 


since: 2.42 


Description 


class WebKit2.ClipboardPermissionRequest : GObject.Object 
implements WebKit2.PermissionRequest { 
priv: WebKitClipboardPermissionRequestPrivate* 


} 
A permission request for reading clipboard contents. 


WebkKitClipboardPermissionRequest represents a request for permission to decide whether WebKit can 
access the clipboard to read its contents through the Async Clipboard API. 


When a WebKitClipboardPermissionRequest is not handled by the user, it is denied by default. 
Available since: 2.42 


Hierarchy 
hierarchy this WebKitClipboardPermissionRequest implements_O|/WebKitPermissionRequest| 


this--implements_O ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Implements 
° 
Instance methods 
Methods inherited from GObject (43) 
Please see GObject for a full list of methods. 


Methods inherited from|WebKitPermissionRequest| (2) 
webkit_permission_request_allow 


Allow the action which triggered this request. 
unstable since: 4.1 
Deny the action which triggered this request. 


unstable since: 4.1 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2ClipboardPermissionRequestClass { 
GObjectClass parent_class; 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 


Content 


Description 
Hierarch 
Ancestors 


e 
e 
e 
@ (Implements 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


PermissionRequest 


Methods 
den 
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Method 


WebKit2PermissionRequestallow 
Declaration 


void 
webkit_permission_request_allow ( 
WebKitPermissionRequest* request 


) 


Description 


Allow the action which triggered this request. 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Generated by[gi-docgen|2023.3 
Method 


WebKit2PermissionRequestdeny 
Declaration 


void 
webkit_permission_request_deny ( 
WebKitPermissionRequest* request 


) 


Description 


Deny the action which triggered this request. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


ColorChooserRequest 


Instance methods 


get_element_rectangle 


Properties 


reba 


Signals 
finished 


Generated by|gi-docgen]2023.3 
Class 


WebKit2;ColorChooserRequest 


unstable since: 4.1 


Description 


class WebKit2.ColorChooserRequest : GObject.Object 
{ 
priv: WebKitColorChooserRequestPrivate* 


} 
A request to open a color chooser. 


Whenever the user interacts with an HTML element, WebKit will need to show a dialog to choose a color. 
For that to happen in a general way, instead of just opening a GtkColorChooser (which might be not 
desirable in some cases, which could prefer to use their own color chooser dialog), WebKit will fire the 
WebKitWebView: :run-color-chooser signal with aWebKitColorChooserRequest object, 
which will allow the client application to specify the color to be selected, to inspect the details of the 
request (e.g. to get initial color) and to cancel the request, in case nothing was selected. 


In case the client application does not wish to handle this signal, WebKit will provide a default handler 
which will asynchronously run a regular GCkColorChooserDialog for the user to interact with. 


Available since: 4.1 


Hierarchy 
hierarchy this WebKitColorChooserRequest ancestor_0 GObject ancestor_0O--this 
Ancestors 
@ GObject 
Instance methods 


webkit_color_chooser_request_cancel 
Cancels request and the input element changes to use the initial color. 
since: 2.8 


webkit_color_chooser_request_finish 


Finishes request and the input element keeps the current value of 
WebKitColorChooserRequest: rgba. 


since: 2.8 
webkit_color_chooser_request_get_element_rectangle 
Gets the bounding box of the color input element. 


since: 2.8 


Gets the current GAkKRGBA color of request. 
since: 2.8 
Sets the current GAkRGBA color of request. 


since: 2.8 


Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 
WebKit2.ColorChooserRequest:rgba 
The GdkRGBA color of the request. 


since: 2.8 


Signals 
WebKit2.ColorChooserRequest::finished 


Emitted when the request finishes. This signal can be emitted because the user completed the 
request calling webkit_color_chooser_request_finishQ), or cancelled it with 
webkit_color_chooser_request_cancel () or because the color input element is removed 
from the DOM. 


since: 2.8 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2ColorChooserRequestClass { 
GObjectClass parent_class; 


} 
No description available. 


Class members 


parent_class: GObjectClass 
No description available. 


Content 


@ |Description 
@ |Hierarch 
@ {Ancestors 


@ |Methods| 
@ [Properties 
e 


Signals 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


ColorChooserRequest 


Methods 
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Method 


WebKit2ColorChooserRequestcancel 


since: 2.8 


Declaration 


void 


webkit_color_chooser_request_cancel ( 


WebKitColorChooserRequest* request 


) 


Description 


Cancels request and the input element changes to use the initial color. 

Cancels request and the input element changes to use the initial color it has before the request started. 
The signal WebKitColorChooserRequest: : finished is emitted to notify that the request 

has finished. 


Available since: 2.8 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


ColorChooserRequest 


Methods 
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Method 


WebKit2ColorChooserRequestfinish 


since: 2.8 


Declaration 


void 


webkit_color_chooser_request_finish ( 


WebKitColorChooserRequest* request 


) 


Description 


Finishes request and the input element keeps the current value of 
WebKitColorChooserRequest: rgba. 


Finishes request and the input element keeps the current value of 
WebKitColorChooserRequest: rgba. The signal 
WebKitColorChooserRequest: : finished is emitted to notify that the request has finished. 


Available since: 2.8 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


ColorChooserRequest 


Methods 
get_element_rectangle 
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Method 


WebKit J olorChooserRequestget_element_rectangle 


since: 2.8 


Declaration 


void 
webkit_color_chooser_request_get_element_rectangle ( 
WebKitColorChooserRequest* request, 
GdkRectangle* rect 
) 


Description 


Gets the bounding box of the color input element. 
Available since: 2.8 
Parameters 
rect 
Type: GdkRectangle 


A GdkRectangle to fill in with the element area. 


The argument will be set by the function. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


ColorChooserRequest 


Methods 
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Method 


WebKit2ColorChooserRequestget_rgba 


since: 2.8 


Declaration 


void 

webkit_color_chooser_request_get_rgba ( 
WebKitColorChooserRequest* request, 
GdkRGBA* rgba 

) 


Description 


Gets the current GAkKRGBA color of request. 


Available since: 2.8 


Gets property |WebKit2.ColorChooserRequest:rgba 


Parameters 


rgba 


Type: GAKRGBA 


A GdkRGBA to fill in with the current color. 


The argument will be set by the function. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


ColorChooserRequest 


Methods 
get_element_rectangle 
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Method 


WebKit2ColorChooserRequestset_rgba 


since: 2.8 


Declaration 


void 

webkit_color_chooser_request_set_rgba ( 
WebKitColorChooserRequest* request, 
const GdkRGBA* rgba 

) 


Description 


Sets the current GAkRGBA color of request. 


Available since: 2.8 


Sets property [WebKit2.ColorChooserRequest:rgba 


Parameters 


rgba 


Type: GAKRGBA 


A pointer GAkKRGBA. 


The data is owned by the caller of the method. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


ColorChooserRequest 


Properties 


reba 
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Property 
WebKit2ColorChooserRequestrrgba 
since: 2.8 

Declaration 


property rgba: Gdk.RGBA [ read, write, construct ] 


Description 


The GdkRGBA color of the request. 


Type: GdkRGBA 


Available since: 2.8 


Getter method |webkit_color_chooser_request_get_rgba() 


Setter method webkit_color_chooser_request_set_rgba () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
yes 


no 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


ColorChooserRequest 
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Signal 
[WebKit4ColorChooserRequest;:finished 
since: 2.8 

Declaration 

Finished | 


WebKitColorChooserRequest* self, 
gpointer user_data 


Description 


Emitted when the request finishes. This signal can be emitted because the user completed the 
request calling webkit_color_chooser_request_finishQ, or cancelled it with 
webkit_color_chooser_request_cancel () or because the color input element is removed 
from the DOM. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.8 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Constructors 
ew 


Instance methods 


append}first|get_event|get_item_at_position|]get_items]get_n_items]get_user_datafinsert}last}{move_item 
prepend|removelremove_all]set_user_datal 


Generated by[gi-docgen]2023.3 
Class 


W ebKit2;ContextMenu 


unstable since: 4.1 


Description 


class WebKit2.ContextMenu : GObject.Object 
{ 
priv: WebKitContextMenuPrivate* 


} 


Represents the context menu in a WebKitWebView. 


WebKitContextMenu represents a context menu containing WebKit ContextMenuItems ina 
WebKitWebView. 


When a WebKitWebView is about to display the context menu, it emits the 

WebKitWebView: :context—menu signal, which has the WebKitContextMenu as an argument. 
You can modify it, adding new submenus that you can create with webkit_context_menu_new(), adding 
new WebKitContextMenulItems with webkit_context_menu_prepend(), 
webkit_context_menu_append() or webkit_context_menu_insert(), maybe after having removed 
the existing ones with webkit_context_menu_remove_all(). 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitContextMenu ancestor_0 GObject ancestor_O--this 


Ancestors 


@ GObject 


Constructors 


webkit_context_menu_new 


Creates anew WebKit ContextMenu object. 
unstable since: 4.1 
Creates a new WebKit ContextMenu object with the given items. 


unstable since: 4.1 


Instance methods 


webkit_context_menu_append 


Adds item at the end of the menu. 
unstable since: 4.1 

Gets the first item in the menu. 
unstable since: 4.1 


webkit_context_menu_get_event 


Gets the GdkEvent that triggered the context menu. This function only returns a valid GdkEvent when 
called fora WebKitContextMenu passed to WebKitWebView: : context—menu signal; in all 
other cases, NULL is returned. 


since: 2.40 


webkit_context_menu_get_item_at_position 


Gets the item at the given position in the menu. 
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webkit_context_menu_get_items 


Returns the item list of menu. 
unstable since: 4.1 
webkit_context_menu_get_n_items 
Gets the length of the menu. 
unstable since: 4.1 

Gets the user data of menu. 

since: 2.8 


webkit_context_menu_insert! 


Inserts item into the menu at the given position. 
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webkit_context_menu_last 


Gets the last item in the menu. 
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webkit_context_menu_move_item 


Moves item to the given position in the menu. 
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webkit_context_menu_prepend 


Adds item at the beginning of the menu. 


unstable since: 4.1 


webkit_context_menu_remove 


Removes item from the menu. 
unstable since: 4.1 
webkit_context_menu_remove_all 
Removes all items of the menu. 


unstable since: 4.1 


webkit_context_menu_set_user_data 


Sets user data to menu. 
since: 2.8 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2ContextMenuClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 
void 


i 


No description available. 
Class members 


parent_class: 
No description available. 

_webkit_reserved0: void 
No description available. 

_webkit_reservedl: void 
No description available. 

_webkit_reserved2: void 
No description available. 

_webkit_reserved3: void 
No description available. 


Content 


Description 
Hierarch 


Constructors 


e 
e 
@ {Ancestors 
e 
@ |Methods 


GObjectClass 


(* 


(* 


(* 


(* 


_webkit_reserved0) 


_webkit_reservedl1) 


_webkit_reserved2) 


_webkit_reserved3) 


void 


void 


void 


void 


) 


) 


) 


) 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Constructors 
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Constructor 


WebKitContextMenunew 
Declaration 


WebKitContextMenu* 
webkit_context_menu_new ( 
void 


) 


Description 


Creates a new WebKit ContextMenu object. 


Creates anew WebKit ContextMenu object to be used as a submenu of an existing 
WebKitContextMenu. The context menu of a WebKit WebView is created by the view and passed as 
an argument of WebKitWebView: :context—menu signal. To add items to the menu use 
webkit_context_menu_prepend(), webkit_context_menu_append () or 
webkit_context_menu_insert(). See also webkit_context_menu_new_with_items () to create a 
WebKitContextMenu with a list of initial items. 


Return value 


Type: |WebKitContextMenu 


The newly created WebKitContextMenu object. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Constructors 
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Constructor 


WebKit2ContextMenunew_with_items 
Declaration 


WebKitContextMenu* 
webkit_context_menu_new_with_items ( 
GList* items 


) 


Description 


Creates a new WebKitContextMenu object with the given items. 


Creates a new WebKit ContextMenu object to be used as a submenu of an existing 
WebKitContextMenu with the given initial items. See also webkit_context_menu_new () 


Parameters 
items 
Type: A list of None 


A GList of WebKitContextMenulItem. 


The data is owned by the caller of the function. 


Return value 


Type: |WebKitContextMenu 


The newly created WebKitContextMenu object. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 
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Method 


WebKit2ContextMenuappend 
Declaration 


void 
webkit_context_menu_append ( 
WebKitContextMenu* menu, 
WebKitContextMenuItem* item 
) 


Description 


Adds item at the end of the menu. 


Parameters 
item 


Type:|(WebKitContextMenuItem 


The WebKitContextMenultem to add. 


The data is owned by the caller of the method. 
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Method 


WebKitContextMenufirst 
Declaration 


WebKitContextMenuItem* 
webkit_context_menu_first ( 
WebKitContextMenu* menu 

) 


Description 


Gets the first item in the menu. 


Return value 


Type: |WebKitContextMenuItem 


The first WebKitContextMenuItem of menu, or NULL if the WebKitContextMenu is empty. 


The data is owned by the instance. 
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Library Version: 2.42.4 
Type 


Methods 
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Method 
WebKit3ContextMenuget_event 
since: 2.40 


Declaration 


GdkEvent* 

webkit_context_menu_get_event ( 
WebKitContextMenu* menu 

) 


Description 


Gets the GdkEvent that triggered the context menu. This function only returns a valid GdkEvent when 
called fora WebKitContextMenu passed to WebKitWebView: : context—menu signal; in all 
other cases, NULL is returned. 


The returned GdkEvent is expected to be one of the following types: a GdkEvent Button of type 
GDK_BUTTON_PRESS when the context menu was triggered with mouse. a GdkEvent Key of type 
GDK_KEY_PRESS if the keyboard was used to show the menu. a generic GdkEvent of type 

GDK_NOTHING when the GtkWidget : :popup-—menu signal was used to show the context menu. 


Available since: 2.40 


Return value 
Type: GdkEvent 


The menu event or NULL. 


The data is owned by the instance. 
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API Version: 4.1 


Library Version: 2.42.4 
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Methods 
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Method 


WebKit2ContextMenuget_item_at_position 
Declaration 


WebKitContextMenuItem* 
webkit_context_menu_get_item_at_position ( 
WebKitContextMenu* menu, 
guint position 


) 


Description 
Gets the item at the given position in the menu. 
Parameters 
position 
Type: guint 


The position of the item, counting from 0 


Return value 


Type: |WebKitContextMenuItem 


The WebKitContextMenulItem at position position in menu, or NULL if the position is off the 
end of the menu. 


The data is owned by the instance. 
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API Version: 4.1 
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Method 


WebKit3ContextMenuget_items 
Declaration 


GList* 

webkit_context_menu_get_items ( 
WebKitContextMenu* menu 

) 


Description 


Returns the item list of menu. 


Return value 
Type: A list of None 


A GList of WebKitContextMenultems. 


The data is owned by the instance. 
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Library Version: 2.42.4 
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Methods 
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Method 


WebKit2ContextMenuget_n_items 
Declaration 


guint 

webkit_context_menu_get_n_items ( 
WebKitContextMenu* menu 

) 


Description 


Gets the length of the menu. 


Return value 


Type: guint 


The number of WebKitContextMenuItems in menu. 
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Library Version: 2.42.4 
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Method 
WebKit2ContextMenuget_user_data 
since: 2.8 


Declaration 


GVariant* 
webkit_context_menu_get_user_data ( 
WebKitContextMenu* menu 


) 


Description 


Gets the user data of menu. 


This function can be used from the UI Process to get user data previously set from the Web Process 
with webkit_context_menu_set_user_data(). 


Available since: 2.8 


Return value 


Type: GVariant 


The user data of menu, or NULL if menu doesn’t have user data. 


The data is owned by the instance. 
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Library Version: 2.42.4 
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Methods 
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Method 


WebKitContextMenujnsert 
Declaration 


void 


webkit_context_menu_insert ( 
WebKitContextMenu* menu, 
WebKitContextMenulItem* item, 
gint position 


) 


Description 


Inserts item into the menu at the given position. 


If position is negative, or is larger than the number of items in the WebKitContextMenzu, the item 
is added on to the end of the menu. The first position is 0. 


Parameters 
item 


Type:|WebKitContextMenuItem 


The WebKitContextMenuItem to add. 
The data is owned by the caller of the method. 
position 


Type: gint 


The position to insert the item. 
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Method 


WebKitContextMenulast 
Declaration 


WebKitContextMenuItem* 

webkit_context_menu_last ( 
WebKitContextMenu* menu 

) 


Description 


Gets the last item in the menu. 


Return value 


Type: |WebKitContextMenuItem 


The last WebKitContextMenulItem of menu, or NULL if the WebKitContextMenu is empty. 


The data is owned by the instance. 


| 


WebKit2 
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Library Version: 2.42.4 
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Methods 
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Method 


WebKit2ContextMenumove_item 
Declaration 


void 


webkit_context_menu_move_item ( 
WebKitContextMenu* menu, 
WebKitContextMenulItem* item, 
gint position 


) 


Description 


Moves item to the given position in the menu. 


If position is negative, or is larger than the number of items in the WebKitContextMenzu, the item 
is added on to the end of the menu. The first position is 0. 


Parameters 
item 


Type:|WebKitContextMenuItem 


The WebKitContextMenuItem to add. 
The data is owned by the caller of the method. 
position 


Type: gint 


The new position to move the item. 
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Type 
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Method 


WebKit2ContextMenuprepend 
Declaration 


void 
webkit_context_menu_prepend ( 
WebKitContextMenu* menu, 
WebKitContextMenulItem* item 
) 


Description 


Adds item at the beginning of the menu. 


Parameters 
item 


Type:|(WebKitContextMenuItem 


The WebKitContextMenultem to add. 


The data is owned by the caller of the method. 
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Method 


WebKit3ContextMenuremove 
Declaration 


void 


webkit_context_menu_remove ( 
WebKitContextMenu* menu, 
WebKitContextMenuItem* item 
) 


Description 


Removes item from the menu. 


See also webkit_context_menu_remove_all() to remove all items. 


Parameters 
item 


Type:|(WebKitContextMenuItem 


The WebKitContextMenultem to remove. 


The data is owned by the caller of the method. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
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Methods 
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Method 


WebKit2ContextMenuremove_all 
Declaration 


void 


webkit_context_menu_remove_all ( 
WebKitContextMenu* menu 
) 


Description 


Removes all items of the menu. 
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Method 
WebKit2ContextMenuset_user_data 
since: 2.8 


Declaration 


void 

webkit_context_menu_set_user_data ( 
WebKitContextMenu* menu, 
GVariant* user_data 


) 


Description 


Sets user data to menu. 


This function can be used from a Web Process extension to set user data that can be retrieved from the UI 
Process using webkit_context_menu_get_user_data(). If the user_data GVariant is floating, it 
is consumed. 


Available since: 2.8 


Parameters 
user_data 
Type: GVariant 


A GVariant. 


The data is owned by the caller of the method. 
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Class 


WebKit2;ContextMenultem 


unstable since: 4.1 


Description 


class WebKit2.ContextMenuItem : GObject.InitiallyUnowned 
{ 
priv: WebKitContextMenulItemPrivate* 


} 
One item of aWebKitContextMenu. 


The WebKitContextMenu is composed of WebKitContextMenulItems. These items can be 
created from a GtkAction, from a WebKitContextMenuAction or froma 
WebKitContextMenuAction and a label. These WebKit ContextMenuActions denote stock 
actions for the items. You can also create separators and submenus. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitContextMenulItem ancestor_0 GlInitiallyUnowned ancestor_0--this ancestor_1 
GObject ancestor_1--ancestor_0 


Ancestors 


@ GlnitiallyUnowned 
@ GObject 


Constructors 


webkit_context_menu_item_new 


Creates anew WebKitContextMenulten for the given action. 
unstable deprecated: 2.18 since: 4.1 
Creates anew WebKitContextMenulItenm for the given action and label. 


since: 2.18 


webkit_context_menu_item_new_from_stock_action 


Creates a new WebKit ContextMenuItenm for the given stock action. 


unstable since: 4.1 


webkit_context_menu_item_new_from_stock_action_with_label 


Creates a new WebKit ContextMenuItenm for the given stock action using the given label. 
unstable since: 4.1 

Creates a new WebKit ContextMenuItem representing a separator. 

unstable since: 4.1 

Creates anew WebKitContextMenuItem using the given label with a submenu. 


unstable since: 4.1 


Instance methods 


webkit_context_menu_item_get_action 


Gets the action associated to item as a GtkAction. 
unstable deprecated: 2.18 since: 4.1 

Gets the action associated to item as a GAction. 
since: 2.18 
[webkit_context_menu_item_get_stock_action] 
Gets the WebKitContextMenuAction of item. 
unstable since: 4.1 
[webkit_context_menu_item_get_submenu] 

Gets the submenu of item. 

unstable since: 4.1 

Checks whether item is a separator. 

unstable since: 4.1 

Sets or replaces the item submenu. 

unstable since: 4.1 

Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 
Signals inherited from GObject (1) 


GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2ContextMenulItemClass { 
GInitiallyUnownedClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GInitiallyUnownedClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Constructor 


WebKit3ContextMenulItemhew 


deprecated: 2.18 


Declaration |[src] 


WebKitContextMenuItem* 

webkit_context_menu_item_new ( 
GtkAction* action 

) 


Description |[src] 
Creates anew WebKitContextMenultenm for the given action. 


Deprecated since: 2.18 


Use webkit_context_menu_item_new_from_gaction () instead. 


Parameters 
action 


Type: GtkAction 


A GtkAction. 


The data is owned by the caller of the function. 


Return value 


Type: |WebKitContextMenuItem 


The newly created WebKitContextMenulItem object. 


The data is owned by the called function. 
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Constructors 
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Constructor 
WebKit2ContextMenulItemnew_from_gaction 
since: 2.18 


Declaration 


WebKitContextMenulItem* 
webkit_context_menu_item_new_from_gaction ( 
GAction* action, 
const gchar* label, 
GVariant* target 
) 


Description 

Creates anew WebKitContextMenulItenm for the given action and label. 
On activation target will be passed as parameter to the callback. 

Available since: 2.18 

Parameters 


action 


Type: GAction 


A GAction. 


The data is owned by the caller of the function. 


label 
Type: const gchar* 
The menu item label text. 
The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


target 
Type: GVariant 


A GVariant to use as the action target. 


The argument can be NULL. 


The data is owned by the caller of the function. 


Return value 


Type: |WebKitContextMenuItem 


The newly created WebKitContextMenulItem object. 


The data is owned by the called function. 
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Constructor 


WebKit2ContextMenultemnew_from_stock_action 
Declaration 


WebKitContextMenuItem* 
webkit_context_menu_item_new_from_stock_action ( 
WebKitContextMenuAction action 


) 


Description 


Creates a new WebKit ContextMenuItenm for the given stock action. 


Stock actions are handled automatically by WebKit so that, for example, when a menu item created with a 
WEBKIT_CONTEXT_MENU_ACTION_STOP is activated the action associated will be handled by 
WebKit and the current load operation will be stopped. You can get the GAction ofa 
WebKitContextMenulItem created with a WebKitContextMenuAction with 
webkit_context_menu_item_get_gaction() and connect to the 

GSimpleAction: :activate signal to be notified when the item is activated, but you can’t prevent 
the associated action from being performed. 


Parameters 


action 


Type:|WebKitContextMenuAction 


A WebKitContextMenuAction stock action. 


Return value 


Type: |WebKitContextMenuItem 


The newly created WebKitContextMenulItem object. 


The data is owned by the called function. 
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Inew|new_from_gaction new_from_stock_action{new_from_stock_action_with_labelfnew_separator 
new_with_submenu 


Generated by[gi-docgen]2023.3 


Constructor 


WebKit J ontextMenultemnew_from_stock_action_with_label 
Declaration 


WebKitContextMenuItem* 
webkit_context_menu_item_new_from_stock_action_with_label ( 
WebKitContextMenuAction action, 
const gchar* label 


) 


Description 


Creates a new WebKit ContextMenuItenm for the given stock action using the given label. 


Stock actions have a predefined label, this method can be used to create aWebKitContextMenulItem 
fora WebKitContextMenuAction but using a custom label. 


Parameters 


action 


Type:|WebKitContextMenuAction 


A WebKitContextMenuAction stock action. 


label 
Type: const gchar* 


A custom label text to use instead of the predefined one. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitContextMenuItem 


The newly created WebKitContextMenulItem object. 


The data is owned by the called function. 
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Constructor 


WebKit2ContextMenulItemnew_separator 
Declaration 


WebKitContextMenulItem* 
webkit_context_menu_item_new_separator ( 
void 


) 


Description 


Creates a new WebKit ContextMenuItem representing a separator. 


Return value 


Type: |WebKitContextMenuItem 


The newly created WebKitContextMenulItem object. 


The data is owned by the called function. 
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Constructor 


WebKit J ontextMenultemnew_with_submenu 
Declaration 


WebKitContextMenuItem* 
webkit_context_menu_item_new_with_submenu ( 
const gchar* label, 
WebKitContextMenu* submenu 


) 


Description 
Creates a new WebKitContextMenuItem using the given label with a submenu. 
Parameters 
label 
Type: const gchar* 
The menu item label text. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


submenu 


Type:|WebKitContextMenu 


A WebKitContextMenu to set. 


The data is owned by the caller of the function. 


Return value 


Type: |WebKitContextMenuItem 


The newly created WebKitContextMenulItem object. 


The data is owned by the called function. 
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Method 


WebKit2ContextMenultemget_action 


deprecated: 2.18 


Declaration 


GtkAction* 
webkit_context_menu_item_get_action ( 
WebKitContextMenuItem* item 


) 


Description 


Gets the action associated to item as aGtkAction. 
Deprecated since: 2.18 


Use webkit_context_menu_item_get_gaction () instead. 


Return value 
Type: GtkAction 


The GtkAction associated to the WebKitContextMenuItem, or NULL if item is a separator. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 
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Method 
WebKit3ContextMenultemget_gaction 
since: 2.18 


Declaration 


GAction* 
webkit_context_menu_item_get_gaction ( 
WebKitContextMenuItem* item 


) 


Description 


Gets the action associated to item as a GAction. 


Available since: 2.18 


Return value 
Type: GAction 


The GAct ion associated to the WebKitContextMenulItem, or NULL if item is a separator. 


The data is owned by the instance. 
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Method 


WebKit | ontextMenultemeget_stock_action 
Declaration 


WebKitContextMenuAction 

webkit_context_menu_item_get_stock_action ( 
WebKitContextMenuItem* item 

) 


Description 


Gets the WebKitContextMenuAction of item. 


If the WebKitContextMenultem was not created for a stock action 
WEBKIT_ CONTEXT _MENU_ACTION_ CUSTOM will be returned. If the WebKitContextMenulItem is 
a separator WEBKIT_CONTEXT_MENU_ACTION_NO_ACTION will be returned. 


Return value 


Type: |WebKitContextMenuAction 


The WebKitContextMenuAction of item. 
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Method 


WebKit2ContextMenultemget_submenu 
Declaration 


WebKitContextMenu* 
webkit_context_menu_item_get_submenu ( 
WebKitContextMenuItem* item 


) 


Description 


Gets the submenu of item. 


Return value 


Type: |WebKitContextMenu 


The WebKitContextMenu representing the submenu of item or NULL if item doesn’t have 
a submenu. 


The data is owned by the instance. 
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Method 


WebKit | ontextMenulItemis_separator 
Declaration 


gboolean 

webkit_context_menu_item_is_separator ( 
WebKitContextMenuItem* item 

) 


Description 


Checks whether item is a separator. 
Return value 
Type: gboolean 


TRUE is item is a separator or FALSE otherwise. 
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Method 


WebKit3ContextMenulItembet_submenu 
Declaration 


void 

webkit_context_menu_item_set_submenu ( 
WebKitContextMenuItem* item, 
WebKitContextMenu* submenu 


) 


Description 


Sets or replaces the item submenu. 
If submenu is NULL the current submenu of item is removed. 
Parameters 


submenu 


Type: |WebKitContextMenu 


A WebKitContextMenu. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Class 


WebKit2;CookieManager 


unstable since: 4.1 


Description 


class WebKit2.CookieManager : GObject.Object 
{ 
priv: WebKitCookieManagerPrivate* 


} 


Defines how to handle cookies in a WebKitWebContext. 


The WebKitCookieManager defines how to set up and handle cookies. You can get it from a 


WebKitWebsiteDataManager with webkit_website_data_manager_get_cookie_manager(), and use 
it to set where to store cookies with webkit_cookie_manager_set_persistent_storage(), or to set the 


acceptance policy, with webkit_cookie_manager_get_accept_policy(). 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitCookieManager ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 


webkit_cookie_manager_add_cookie 


Asynchronously add a SoupCookie to the underlying storage. 

since: 2.20 

Finish an asynchronous operation started with webkit_cookie_manager_add_cookie(). 
since: 2.20 

Delete all cookies of cookie_manager. 

unstable deprecated: 2.16 since: 4.1 

Asynchronously delete a SoupCookie from the current session. 

since: 2.20 

Finish an asynchronous operation started with webkit_cookie_manager_delete_cookie(). 
since: 2.20 

Remove all cookies of cookie_manager for the given domain. 


unstable deprecated: 2.16 since: 4.1 


webkit_cookie_manager_get_accept_policy 
Asynchronously get the cookie acceptance policy of cookie_manager. 


unstable since: 4.1 


webkit_cookie_manager_get_accept_policy_finish 


Finish an asynchronous operation started with webkit_cookie_manager_get_accept_policy(). 
unstable since: 4.1 

Asynchronously get a list of SoupCookie from cookie_manager. 

since: 2.42 

Finish an asynchronous operation started with webkit_cookie_manager_get_all_cookies(). 
since: 2.42 

Asynchronously get a list of SoupCookie from cookie_manager. 


since: 2.20 


webkit_cookie_manager_get_cookies_finish 


Finish an asynchronous operation started with webkit_cookie_manager_get_cookies(). 


since: 2.20 


webkit_cookie_manager_get_domains_with_cookies 


Asynchronously get the list of domains for which cookie_manager contains cookies. 


unstable deprecated: 2.16 since: 4.1 


webkit_cookie_manager_get_domains_with_cookies_finish 


Finish an asynchronous operation started with webkit_cookie_manager_get_domains_with_cookies(). 


unstable deprecated: 2.16 since: 4.1 


webkit_cookie_manager_replace_cookies 


Asynchronously replace all cookies in cookie_manager with the given list of cookies. 


since: 2.42 


webkit_cookie_manager_replace_cookies_finish 


Finish an asynchronous operation started with webkit_cookie_manager_replace_cookies(). 
since: 2.42 
Set the cookie acceptance policy of cookie_manager as policy. 


unstable since: 4.1 


webkit_cookie_manager_set_persistent_storage 


Set non-session cookies. 
unstable since: 4.1 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 
WebKit2.CookieManager::changed 


This signal is emitted when cookies are added, removed or modified. 
unstable since: 4.1 

Signals inherited from GObject (1) 

GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2CookieManagerClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
\e 
void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Method 


WebKit4CookieManageradd_cookie 


since: 2.20 


Declaration 


void 

webkit_cookie_manager_add_cookie ( 
WebKitCookieManager* cookie_manager, 
SoupCookie* cookie, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously add a SoupCookie to the underlying storage. 


When the operation is finished, callback will be called. You can then call 
webkit_cookie_manager_add_cookie_finish () to get the result of the operation. 


Available since: 2.20 
Parameters 
cookie 
Type: SoupCookie 
The SoupCookie to be added. 


The data is owned by the caller of the method. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


Generated by[gi-docgen]2023.3 
Method 


WebKit4CookieManageradd_cookie_finish 


since: 2.20 


Declaration 


gboolean 
webkit_cookie_manager_add_cookie_finish ( 
WebKitCookieManager* cookie_manager, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_cookie_manager_add_cookie(). 


Available since: 2.20 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error| 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 

Return value 

Type: gboolean 


TRUE if the cookie was added or FALSE in case of error. 
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Method 


WebKit2CookieManagertlelete_all_cookies 


deprecated: 2.16 


Declaration 


void 
webkit_cookie_manager_delete_all_cookies ( 


WebKitCookieManager* cookie_manager 


) 


Description 


Delete all cookies of cookie_manager. 
Deprecated since: 2.16 


Use webkit_website_data_manager_clear () instead. 
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Method 


WebKit4CookieManagerdelete_cookie 


since: 2.20 


Declaration 


void 
webkit_cookie_manager_delete_cookie ( 
WebKitCookieManager* cookie_manager, 
SoupCookie* cookie, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously delete a SoupCookie from the current session. 


When the operation is finished, callback will be called. You can then call 
webkit_cookie_manager_delete_cookie_finish() to get the result of the operation. 


Available since: 2.20 
Parameters 
cookie 
Type: SoupCookie 
The SoupCockie to be deleted. 


The data is owned by the caller of the method. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2CookieManagertelete_cookie_finish 


since: 2.20 


Declaration 


gboolean 
webkit_cookie_manager_delete_cookie_finish ( 
WebKitCookieManager* cookie_manager, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_cookie_manager_delete_cookie(). 


Available since: 2.20 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error| 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 

Return value 

Type: gboolean 


TRUE if the cookie was deleted or FALSE in case of error. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


Generated by[gi-docgen]2023.3 
Method 


WebKit2CookieManager(lelete_cookies_for_domain 


deprecated: 2.16 


Declaration 


void 
webkit_cookie_manager_delete_cookies_for_domain ( 


WebKitCookieManager* cookie_manager, 
const gchar* domain 


) 


Description 


Remove all cookies of cookie_manager for the given domain. 
Deprecated since: 2.16 


Use webkit_website_data_manager_remove () instead. 


Parameters 

domain 
Type: const gchar* 
A domain name. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit3CookieManagerget_accept_policy 
Declaration 


void 
webkit_cookie_manager_get_accept_policy ( 
WebKitCookieManager* cookie_manager, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously get the cookie acceptance policy of cookie_manager. 


Note that when policy was set to WEBKIT_COOKIE_POLICY_ACCEPT_NO_THIRD_PARTY and ITP 
is enabled, this will return WEBKIT_COOKIE_POLICY_ACCEPT_ ALWAYS. See 
also webkit_website_data_manager_set_itp_enabled(). 


When the operation is finished, callback will be called. You can then call 
webkit_cookie_manager_get_accept_policy_finish () to get the result of the operation. 


Parameters 
cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


Generated by[gi-docgen]2023.3 
Method 


WebKit2CookieManagerget_accept_policy_finish 
Declaration 


WebKitCookieAcceptPolicy 
webkit_cookie_manager_get_accept_policy_finish ( 
WebKitCookieManager* cookie_manager, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_cookie_manager_get_accept_policy(). 
Parameters 
result 


Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 


Type: |WebKitCookieAcceptPolicy 


The cookie acceptance policy of cookie_manager as aWebKitCookieAcceptPolicy. 
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Library Version: 2.42.4 
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Method 


WebKit3CookieManagerget_all_cookies 


since: 2.42 


Declaration 


void 

webkit_cookie_manager_get_all_cookies ( 
WebKitCookieManager* cookie_manager, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously get a list of SoupCookie from cookie_manager. 


When the operation is finished, callback will be called. You can then call 
webkit_cookie_manager_get_all_cookies_finish () to get the result of the operation. 


Available since: 2.42 
Parameters 
cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


(closure user_data): a GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Library Version: 2.42.4 


Type 
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Method 
WebKit2CookieManagerget_all_cookies_finish 
since: 2.42 


Declaration 


GList* 
webkit_cookie_manager_get_all_cookies_finish ( 


WebKitCookieManager* cookie_manager, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_cookie_manager_get_all_cookies(). 


The return value is a GSList of SoupCookie instances which should be released with 
g_list_free_full() and soup_cookie_free(). 


Available since: 2.42 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error| 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 
Type: A list of SoupCookie* 


A GList of SoupCookie instances. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Library Version: 2.42.4 
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Methods 


Generated by[gi-docgen]2023.3 
Method 


WebKit2CookieManagerget_cookies 


since: 2.20 


Declaration 


void 
webkit_cookie_manager_get_cookies ( 
WebKitCookieManager* cookie_manager, 
const gchar* uri, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously get a list of SoupCookie from cookie_manager. 


Asynchronously get a list of SoupCookie from cookie_manager associated with uri, which must 
be either an HTTP or an HTTPS URL. 


When the operation is finished, callback will be called. You can then call 
webkit_cookie_manager_get_cookies_finish () to get the result of the operation. 


Available since: 2.20 
Parameters 
uri 
Type: const gchar* 
The URI associated to the cookies to be retrieved. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 
WebKit2CookieManagerget_cookies_finish 
since: 2.20 


Declaration 


GList* 
webkit_cookie_manager_get_cookies_finish ( 


WebKitCookieManager* cookie_manager, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_cookie_manager_get_cookies(). 


The return value is a GSList of SoupCookie instances which should be released with 
g_list_free_full() and soup_cookie_free(). 


Available since: 2.20 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error| 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 
Type: A list of SoupCookie* 


A GList of SoupCookie instances. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2CookieManagerget_domains_with_cookies 


deprecated: 2.16 


Declaration 


void 
webkit_cookie_manager_get_domains_with_cookies ( 
WebKitCookieManager* cookie_manager, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


) 


Description 


Asynchronously get the list of domains for which cookie_manager contains cookies. 


When the operation is finished, callback will be called. You can then call 
webkit_cookie_manager_get_domains_with_cookies_finish() to get the result of 
the operation. 


Deprecated since: 2.16 
Use webkit_website_data_manager_fetch () instead. 
Parameters 
cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 
A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2CookieManagerget_domains_with_cookies_finish 


deprecated: 2.16 


Declaration 


gchar** 
webkit_cookie_manager_get_domains_with_cookies_finish ( 
WebKitCookieManager* cookie_manager, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_cookie_manager_get_domains_with_cookies(). 
The return value is a NULL terminated list of strings which should be released with g_strfreev(). 


Deprecated since: 2.16 


Use webkit_website_data_manager_fetch_finish () instead. 
Parameters 
result 

Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 
Return value 
Type: An array of ut £8 
A NULL terminated array of domain names or NULL in case of error. 
The array is NULL-terminated. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


Each element is a NUL terminated UTF-8 string. 
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Method 


WebKit2CookieManagerreplace_cookies 


since: 2.42 


Declaration 


void 
webkit_cookie_manager_replace_cookies ( 
WebKitCookieManager* cookie_manager, 
GList* cookies, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously replace all cookies in cookie_manager with the given list of cookies. 


When the operation is finished, callback will be called. You can then call 
webkit_cookie_manager_replace_cookies_finish () to get the result of the operation. 


Available since: 2.42 
Parameters 
cookies 

Type: A list of SoupCookie* 


A GList of SoupCookie to be added. 


The data is owned by the caller of the method. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


(closure user_data): a GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2CookieManagerreplace_cookies_finish 


since: 2.42 


Declaration 


gboolean 
webkit_cookie_manager_replace_cookies_finish ( 
WebKitCookieManager* cookie_manager, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_cookie_manager_replace_cookies(). 


Available since: 2.42 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error| 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 

Return value 

Type: gboolean 


TRUE if the cookies were added or FALSE in case of error. 
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Method 


WebKitaCookieManagerset_accept_policy 
Declaration 


void 
webkit_cookie_manager_set_accept_policy ( 


WebKitCookieManager* cookie_manager, 
WebKitCookieAcceptPolicy policy 
) 


Description 


Set the cookie acceptance policy of cookie_manager as policy. 


Note that ITP has its own way to handle third-party cookies, so when it’s enabled, and policy is set to 


WEBKIT_COOKIE_POLICY_ACCEPT_NO_THIRD_PARTY, 


WEBKIT_COOKIE_POLICY_ACCEPT_ALWAYS will be used instead. Once disabled, the policy will be 


set back to WEBKIT_COOKIE_POLICY_ACCEPT NO _THIRD_ PARTY. See 
also webkit_website_data_manager_set_itp_enabled(). 


Parameters 
policy 


Type:|WebKitCookieAcceptPolicy 


A WebKitCookieAcceptPolicy. 
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Method 


WebKit2CookieManagerset_persistent_storage 


Declaration 


void 
webkit_cookie_manager_set_persistent_storage ( 


WebKitCookieManager* cookie_manager, 

const gchar* filename, 

WebKitCookiePersistentStorage storage 
) 


Description 


Set non-session cookies. 


Set the £ilename where non-session cookies are stored persistently using storage as the format to 
read/write the cookies. Cookies are initially read from filename to create an initial set of cookies. Then, 
non-session cookies will be written to filename when the WebKitCookieManager::changed signal is 
emitted. By default, cookie_manager doesn’t store the cookies persistently, so you need to call this 
method to keep cookies saved across sessions. 


This method should never be called on a WebKitCookieManager associated to an ephemeral 
WebKitWebsiteDataManager. 


Parameters 
filename 
Type: const gchar* 
The filename to read to/write from. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


storage 


Type:|(WebKitCookiePersistentStorage 


A WebKitCookiePersistentStorage. 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


Generated by[gi-docgen|2023.3 
Signal 


WebKit2CookieManagert:changed 


unstable since: 4.1 


Declaration 


void 

changed ( 
WebKitCookieManager* self, 
gpointer user_data 


) 


Description 


This signal is emitted when cookies are added, removed or modified. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 
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API Version: 4.1 


Library Version: 2.42.4 

Type 
DeviceInfoPermissionRequest 
Generated by 2023.3 


Class 


WebKit2DeviceInfoPermissionRequest 


since: 2.24 


Description 


class WebKit2.DeviceInfoPermissionRequest : GObject.Object 
implements WebKit2.PermissionRequest { 
priv: WebKitDeviceInfoPermissionRequestPrivate* 


} 


A permission request for accessing user’s audio/video devices. 


WebkKitUserMediaPermissionRequest represents a request for permission to whether WebKit should be 
allowed to access the user’s devices information when requested through the enumerateDevices API. 


When a WebkKitDeviceInfoPermissionRequest is not handled by the user, it is denied by default. 
Available since: 2.24 


Hierarchy 
hierarchy this WebKitDeviceInfoPermissionRequest implements_O|WebKitPermissionRequest 


this--implements_0 ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Implements 
° 
Instance methods 
Methods inherited from GObject (43) 
Please see GObject for a full list of methods. 


Methods inherited from|WebKitPermissionRequest| (2) 
webkit_permission_request_allow 


Allow the action which triggered this request. 
unstable since: 4.1 
Deny the action which triggered this request. 


unstable since: 4.1 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2DeviceInfoPermissionRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 


void (* _webkit_reservedl) ( 


void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 


void 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* 
No description available. 

_webkit_reservedl: void (* 
No description available. 

_webkit_reserved2: void (* 
No description available. 

_webkit_reserved3: void (* 
No description available. 


Content 


escription 
ierarch 
ncestors 


Implements 


_webkit_reserved0) 


_webkit_reservedl1) 


_webkit_reserved2) 


_webkit_reserved3) 


void 


void 


void 


void 


) 


) 


) 


) 
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Class 


W ebKit2Download 


unstable since: 4.1 


Description 


class WebKit2.Download : GObject.Object 
{ 
priv: WebKitDownloadPrivate* 


} 
Object used to communicate with the application when downloading. 


WebKitDownload carries information about a download request and response, including a 
WebKitURIRequest and a WebKit URIResponse objects. The application may use this object to 
control the download process, or to simply figure out what is to be downloaded, and handle the download 


process itself. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitDownload ancestor_O0 GObject ancestor_0--this 
Ancestors 
@ GObject 


Instance methods 


webkit_download_cancel 


Cancels the download. 


unstable since: 4.1 


webkit_download_get_allow_overwrite 


Returns the current value of the WebKitDownload:allow-overwrite property. 
since: 2.6 
Obtains the destination to which the downloaded file will be written. 


unstable since: 4.1 


webkit_download_ 


Gets the elapsed time in seconds, including any fractional part. 
unstable since: 4.1 


webkit_download_get_estimated_progress 


Gets the value of the WebKitDownload:estimated-progress property. Gets the value of the 
WebKitDownload:estimated-progress property. You can monitor the estimated progress of the 
download operation by connecting to the notify::estimated-progress signal of download. 


unstable since: 4.1 


webkit_download_get_received_data_length 


Gets the length of the data already downloaded for download. 

unstable since: 4.1 

Retrieves the WebKit URIRequest object that backs the download process. 
unstable since: 4.1 

Retrieves the WebKit URIResponse object that backs the download process. 
unstable since: 4.1 

Get the WebKitWebView that initiated the download. 

unstable since: 4.1 

Sets the WebKitDownload:allow-—overwrite property. 

since: 2.6 

Sets the destination to which the downloaded file will be written. 

unstable since: 4.1 

Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Whether or not the download is allowed to overwrite an existing file on disk. If this property is FALSE 
and the destination already exists, the download will fail. 


since: 2.6 


WebKit2.Download:destination 


The local path to where the download will be saved. 


unstable since: 4.1 


WebKit2.Download:estimated-progress 


An estimate of the percent completion for the download operation. This value will range from 0.0 to 1.0. 
The value is an estimate based on the total number of bytes expected to be received for a download. If you 
need a more accurate progress information you can connect to WebKitDownload: :received-data 
signal to track the progress. 


unstable since: 4.1 


WebKit2.Download:response 


The WebKitURIResponse associated with this download. 


unstable since: 4.1 


Signals 
WebKit2.Download::created-destination 


This signal is emitted after WebKitDownload: :decide-destination and before 
WebKitDownload: : received-data to notify that destination file has been created successfully at 
destination. 


unstable since: 4.1 
WebKit2.Download::decide-destination 


This signal is emitted after response is received to decide a destination for the download using 
webkit_download_set_destination(). If this signal is not handled, the file will be downloaded to 
G_USER_DIRECTORY_DOWNLOAD directory using suggested_filename. 


unstable since: 4.1 


WebKit2.Download::failed 


This signal is emitted when an error occurs during the download operation. The given error, of the 
domain WEBKIT_DOWNLOAD_ERROR, contains further details of the failure. If the download is cancelled 
with webkit_download_cancel(), this signal is emitted with error 
WEBKIT_DOWNLOAD_ERROR_CANCELLED_BY_USER. The download operation finishes after an error 
and WebKitDownload: : finished signal is emitted after this one. 


unstable since: 4.1 


WebKit2.Download::finished 


This signal is emitted when download finishes successfully or due to an error. In case of errors 
WebKitDownload: : failed signal is emitted before this one. 


unstable since: 4.1 


WebKit2.Download::received-data 


This signal is emitted after response is received, every time new data has been written to the destination. 
It’s useful to know the progress of the download operation. 


unstable since: 4.1 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2DownloadClass { 
GObjectClass parent_class; 
gboolean (* decide_destination) ( 
WebKitDownload* download, 
const gchar* suggested_filenam 
i 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 


Class members 


parent_class: 


No description available. 


decide_destination: 
download, 


gboolean 


No description available. 
_webkit_reserved0: 
No description available. 
_webkit_reserved1: 
No description available. 
_webkit_reserved2: 
No description available. 
_webkit_reserved3: 
No description available. 


Virtual methods 


WebKit2.DownloadClass.decide_destination 


No description available. 


unstable since: 4.1 


Content 


void 


void 


void 


void 


GObjectClass 


(* _webkit_reserved0) 


(* _webkit_reservedl1) 


(* _webkit_reserved2) 


(* _webkit_reserved3) 


( 


( 


( 


( 


(* decide_destination) ( 
const gchar* suggested_filename ) 


void ) 


void ) 


void ) 


void ) 


WebKitDownload* 
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Method 


WebKit2Downloadkancel 
Declaration 


void 
webkit_download_cancel ( 

WebKitDownload* download 
) 


Description 


Cancels the download. 


When the ongoing download operation is effectively cancelled the signal WebKitDownload: :failed 
is emitted with WEBKIT_DOWNLOAD_ERROR_CANCELLED_BY_USER error. 
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Method 
WebKit 2D ownloadget_allow_overwrite 
since: 2.6 


Declaration 


gboolean 

webkit_download_get_allow_overwrite ( 
WebKitDownload* download 

) 


Description 


Returns the current value of the WebKitDownload:allow-overwrite property. 


Returns the current value of the WebKitDownload:allow-overwrite property, which determines 
whether the download will overwrite an existing file on disk, or if it will fail if the destination 
already exists. 


Available since: 2.6 


Gets property |WebKit2.Download:allow-overwrite 


Return value 
Type: gboolean 


The current value of the WebKit Download: allow-overwrite property. 
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Method 


WebKit2Downloadget_destination 
Declaration 


const gchar* 

webkit_download_get_destination ( 
WebKitDownload* download 

) 


Description 


Obtains the destination to which the downloaded file will be written. 


You can connect to WebKitDownload: :created-destination to make sure this method returns 
a valid destination. 


Gets property |WebKit2.Download:destination 


Return value 
Type: const gchar* 


The destination or NULL. 


The data is owned by the instance. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 
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Method 


WebKit2Downloadget_elapsed_time 
Declaration 


gdouble 

webkit_download_get_elapsed_time ( 
WebKitDownload* download 

) 


Description 


Gets the elapsed time in seconds, including any fractional part. 

If the download finished, had an error or was cancelled this is the time between its start and the event. 
Return value 

Type: gdouble 


Seconds since the download was started. 
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Method 


WebKit2Downloadget_estimated_progress 
Declaration 


gdouble 

webkit_download_get_estimated_progress ( 
WebKitDownload* download 

) 


Description 


Gets the value of the WebKitDownload:estimated-progress property. Gets the value of the 
WebKitDownload:estimated-progress property. You can monitor the estimated progress of the 
download operation by connecting to the notify::estimated-progress signal of download. 


Gets property |WebKit2.Download:estimated-progress 


Return value 
Type: gdouble 


An estimate of the of the percent complete for a download as a range from 0.0 to 1.0. 
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Method 


WebKit2Downloadget_received_data_length 
Declaration 


guinté4 

webkit_download_get_received_data_length ( 
WebKitDownload* download 

) 


Description 


Gets the length of the data already downloaded for download. 

Gets the length of the data already downloaded for download in bytes. 
Return value 

Type: guint 64 


The amount of bytes already downloaded. 
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Method 


WebKit2Downloadget_request 
Declaration 


WebKitURIRequest* 

webkit_download_get_request ( 
WebKitDownload* download 

) 


Description 


Retrieves the WebKitURIRequest object that backs the download process. 


Return value 


Type: |WebKitURIRequest 


The WebKitURIRequest of download. 


The data is owned by the instance. 


get_allow_overwrite]get_destination]get_elapsed_time]get_estimated_progress 
get_received_data_length set_allow_overwrite}set_destination 
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Library Version: 2.42.4 
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Method 


WebKit2Downloadget_response 
Declaration 


WebKitURIResponse* 

webkit_download_get_response ( 
WebKitDownload* download 

) 


Description 


Retrieves the WebKit URIResponse object that backs the download process. 


Retrieves the WebKit URIResponse object that backs the download process. This method returns NULL 
if called before the response is received from the server. You can connect to notify::response signal to be 
notified when the response is received. 


Gets property |WebKit2.Download: response 


Return value 


Type: |WebKitURIResponse 


The WebKit URIResponse, or NULL if the response hasn’t been received yet. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 
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Method 


WebKit2Downloadget_web_view 
Declaration 


WebKitWebView* 

webkit_download_get_web_view ( 
WebKitDownload* download 

) 


Description 


Get the WebKitWebView that initiated the download. 


Return value 


Type: 


The WebKitWebView that initiated download, or NULL if download was not initiated by a 
WebKitWebView. 


The data is owned by the instance. 
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API Version: 4.1 


Library Version: 2.42.4 
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Methods 
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Method 
WebKit | Downloadset_allow_overwrite 
since: 2.6 


Declaration 


void 
webkit_download_set_allow_overwrite ( 
WebKitDownload* download, 
gboolean allowed 


) 


Description 


Sets the WebKitDownload:allow-—overwrite property. 


Sets the WebKitDownload:allow-overwrite property, which determines whether the download 
may overwrite an existing file on disk, or if it will fail if the destination already exists. 


Available since: 2.6 


Sets property [WebKit2.Download:allow-overwrite 


Parameters 
allowed 
Type: gboolean 


The new value for the WebKitDownload:allow-overwrite property. 
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API Version: 4.1 


Library Version: 2.42.4 
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Methods 
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Method 


WebKit2Downloadset_destination 
Declaration 


void 


webkit_download_set_destination ( 
WebKitDownload* download, 
const gchar* destination 


) 


Description 


Sets the destination to which the downloaded file will be written. 


This method should be called before the download transfer starts or it will not have any effect on the 
ongoing download operation. To set the destination using the filename suggested by the server connect to 
WebKitDownload: :decide-destination signal and call webkit_download_set_destination(). If 
you want to set a fixed destination that doesn’t depend on the suggested filename you can connect to 
notify::response signal and call webkit_download_set_destination(). 


If WebKitDownload: :decide-destination signal is not handled and destination is not set when 
the download transfer starts, the file will be saved with the filename suggested by the server in 
G_USER_DIRECTORY_DOWNLOAD directory. 


Parameters 
destination 
Type: const gchar* 
The destination. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Property 
WebKit2Downloadtallow-overwrite 
since: 2.6 

Declaration 

property allow-overwrite: gboolean [ read, write ] 


Description 


Whether or not the download is allowed to overwrite an existing file on disk. If this property is FALSE 
and the destination already exists, the download will fail. 


Type: gboolean 


Available since: 2.6 


Default value FALSE 


Getter method |webkit_download_get_allow_overwrite() 
Setter method webkit_download_set_allow_overwrite() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


no 
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API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 
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Property 


WebKit2Download; destination 


unstable since: 4.1 


Declaration 


property destination: utf8 [ read ] 


Description 


The local path to where the download will be saved. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_download_get_destination () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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API Version: 4.1 


Library Version: 2.42.4 
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Properties 
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Property 


WebKit2Downloadkestimated-progress 


unstable since: 4.1 


Declaration 


property estimated-progress: double [ read ] 


Description 


An estimate of the percent completion for the download operation. This value will range from 0.0 to 1.0. 
The value is an estimate based on the total number of bytes expected to be received for a download. If you 
need a more accurate progress information you can connect to WebKitDownload: :received-data 


signal to track the progress. 


Type: gdouble 


Available since: 4.1 


Default value 1.000000 


Getter method |webkit_download_get_estimated_progress() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 
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API Version: 4.1 


Library Version: 2.42.4 
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Property 


WebKit2Download response 


unstable since: 4.1 


Declaration 


property response: WebKit2.URIResponse [ read ] 


Description 


The WebKitURIResponse associated with this download. 


Type: WebKitURIResponse 


Available since: 4.1 


Getter method |webkit_download_get_response() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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Signal 


WebKit2Downloadt :created-destination 


unstable since: 4.1 


Declaration 


void 

created_destination ( 
WebKitDownload* self, 
gchar* destination, 
gpointer user_data 


) 


Description 


This signal is emitted after WebKitDownload: :decide-destination and before 
WebKitDownload: :received-data to notify that destination file has been created successfully at 
destination. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 

destination 
Type: gchar* 
The destination. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Signals 


created-destination|decide-destination 
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Signal 


WebKit2Downloadt :decide-destination 


unstable since: 4.1 


Declaration 


gboolean 

decide_destination ( 
WebKitDownload* self, 
gchar* suggested_filename, 
gpointer user_data 


) 


Description 


This signal is emitted after response is received to decide a destination for the download using 
webkit_download_set_destination(). If this signal is not handled, the file will be downloaded to 
G_USER_DIRECTORY_DOWNLOAD directory using suggested_filename. 


Since 2.40, you may handle this signal asynchronously by returning TRUE without calling 
webkit_download_set_destination(). This indicates intent to eventually call 
webkit_download_set_destination(). In this case, the download will not proceed until the destination is set 
or cancelled with webkit_download_cancel(). 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 
suggested_filename 
Type: gchar* 
The filename suggested for the download. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event, or FALSE to propagate the event further. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 
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Signal 


WebKit2Download;:failed 


unstable since: 4.1 


Declaration 


void 

failed ( 
WebKitDownload* self, 
GError* error, 
gpointer user_data 


) 


Description 


This signal is emitted when an error occurs during the download operation. The given error, of the 
domain WEBKIT_DOWNLOAD_ERROR, contains further details of the failure. If the download is cancelled 
with webkit_download_cancel(), this signal is emitted with error 
WEBKIT_DOWNLOAD_ERROR_CANCELLED_BY_USER. The download operation finishes after an error 
and WebKitDownload: : finished signal is emitted after this one. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 
error 
Type: GError 


The GError that was triggered. 


The data is owned by the caller of the function. 
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Library Version: 2.42.4 
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Signals 
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Signal 


WebKit2Download;:finished 


unstable since: 4.1 


Declaration 


void 

finished ( 
WebKitDownload* self, 
gpointer user_data 

) 


Description 


This signal is emitted when download finishes successfully or due to an error. In case of errors 
WebKitDownload: : failed signal is emitted before this one. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 
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Signals 
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Signal 


WebKit2Downloadt :received-data 


unstable since: 4.1 


Declaration 


void 

received_data ( 
WebKitDownload* self, 
guint64 data_length, 
gpointer user_data 


) 


Description 


This signal is emitted after response is received, every time new data has been written to the destination. 
It’s useful to know the progress of the download operation. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 
data_length 
Type: guint 64 


The length of data received in bytes. 
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Virtual Method 


WebKit2Downloadtecide_destination 
Declaration 


gboolean 

decide_destination ( 
WebKitDownload* download, 
const gchar* suggested_filename 


) 


Description 


No description available. 

Parameters 

suggested_filename 
Type: const gchar* 
No description available. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


No description available. 
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API Version: 4.1 
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Class 


WebKit2EditorState 


since: 2.10 


Description 


class WebKit2.EditorState : GObject.Object 
{ 


priv: WebKitEditorStatePrivate* 
} 


Web editor state. 


WebkitEditorState represents the state of aWebKitWebView editor. Use 
webkit_web_view_get_editor_state() to get the WebKitEditorState of a WebKitWebView. 


Available since: 2.10 


Hierarchy 


hierarchy this WebKitEditorState ancestor_0 GObject ancestor_O--this 


Ancestors 


@ GObject 


Instance methods 


webkit_editor_state_get_typing_attributes 


Gets the typing attributes at the current cursor position. 


since: 2.10 


webkit_editor_state_is_copy_available 


Gets whether a copy command can be issued. 


since: 2.20 


webkit_editor_state_is_cut_available 


Gets whether a cut command can be issued. 


since: 2.20 


webkit_editor_state_is_paste_available 


Gets whether a paste command can be issued. 


since: 2.20 


webkit_editor_state_is_redo_available 


Gets whether a redo command can be issued. 


since: 2.20 


webkit_editor_state_is_undo_available 


Gets whether an undo command can be issued. 
since: 2.20 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.EditorState:typing-attributes 


Bitmask of WebKitEditorTypingAttributes flags. See 
webkit_editor_state_get_typing_attributes () for more information. 


since: 2.10 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2EditorStateClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 


void (* _webkit_reservedl) ( 


void (* _webkit_reserved2) ( 


void (* _webkit_reserved3) ( 
void 


i 
} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 


_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Method 
WebKit2EditorStateget_typing_attributes 
since: 2.10 


Declaration 


guint 

webkit_editor_state_get_typing_attributes ( 
WebKitEditorState* editor_state 

) 


Description 


Gets the typing attributes at the current cursor position. 


If there is a selection, this returns the typing attributes of the selected text. Note that in case of a selection, 
typing attributes are considered active only when they are present throughout the selection. 


Available since: 2.10 


Gets property |WebKit2.EditorState:typing-attributes 


Return value 
Type: guint 


A bitmask of WebKitEditorTypingAttributes flags. 
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Library Version: 2.42.4 
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Methods 
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is_undo_available 
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Method 


WebKit | ditorStateis_copy_available 


since: 2.20 


Declaration 


gboolean 

webkit_editor_state_is_copy_available ( 
WebKitEditorState* editor_state 

) 


Description 


Gets whether a copy command can be issued. 
Available since: 2.20 

Return value 

Type: gboolean 


TRUE if copy is currently available. 
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Methods 
is_redo_available 


is_undo_available 
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Method 


WebKit | ditorStateis_cut_available 


since: 2.20 


Declaration 


gboolean 

webkit_editor_state_is_cut_available ( 
WebKitEditorState* editor_state 

) 


Description 


Gets whether a cut command can be issued. 
Available since: 2.20 

Return value 

Type: gboolean 


TRUE if cut is currently available. 
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Library Version: 2.42.4 
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Methods 
is_redo_available 


is_undo_available 
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Method 


WebKit | ditorStateis_paste_available 


since: 2.20 


Declaration 


gboolean 

webkit_editor_state_is_paste_available ( 
WebKitEditorState* editor_state 

) 


Description 


Gets whether a paste command can be issued. 
Available since: 2.20 

Return value 

Type: gboolean 


TRUE if paste is currently available. 
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Methods 
is_redo_available 


is_undo_available 
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Method 


WebKit | ditorStateis_redo_available 


since: 2.20 


Declaration 


gboolean 

webkit_editor_state_is_redo_available ( 
WebKitEditorState* editor_state 

) 


Description 


Gets whether a redo command can be issued. 
Available since: 2.20 

Return value 

Type: gboolean 


TRUE if redo is currently available. 
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Methods 
is_redo_available 
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Method 


WebKit | ditorStateis_undo_available 


since: 2.20 


Declaration 


gboolean 

webkit_editor_state_is_undo_available ( 
WebKitEditorState* editor_state 

) 


Description 


Gets whether an undo command can be issued. 
Available since: 2.20 

Return value 

Type: gboolean 


TRUE if undo is currently available. 
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Property 


WebKit2EditorState:typing-attributes 


since: 2.10 


Declaration 


property typing-attributes: guint [ read ] 


Description 


Bitmask of WebKitEditorTypingAttributes flags. See 
webkit_editor_state_get_typing_attributes () for more information. 


Type: guint 


Available since: 2.10 


Default value 0) 


Getter method |webkit_editor_state_get_typing_attributes () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 
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Class 


W ebKit2FaviconDatabase 


unstable since: 4.1 


Description 


class WebKit2.FaviconDatabase : GObject.Object 
{ 
priv: WebKitFaviconDatabasePrivate* 


} 
Provides access to the icons associated with web sites. 


WebKit will automatically look for available icons in elements on opened pages as well as an existing 
favicon.ico and load the images found into a memory cache if possible. That cache is frozen to an on-disk 
database for persistence. 


If WebKitSettings:enable-private-browsing is TRUE, new icons won’t be added to the 
on-disk database and no existing icons will be deleted from it. Nevertheless, WebKit will still store them 
in the in-memory cache during the current execution. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitFaviconDatabase ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 


webkit_favicon_database_clear 


Clears all icons from the database. 

unstable since: 4.1 

Asynchronously obtains a favicon image. 

unstable since: 4.1 

webkit_favicon_database_get_favicon_finish 

Finishes an operation started with webkit_favicon_database_get_favicon(). 
unstable since: 4.1 

lwebkit_favicon_database_get_favicon_uri] 

Obtains the URI of the favicon for the given page_uri. 

unstable since: 4.1 


Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 
WebKit2.FaviconDatabase::favicon-changed 


This signal is emitted when the favicon URI of page_uri has been changed to favicon_uri in the 
database. You can connect to this signal and call webkit_favicon_database_get_favicon () 
to get the favicon. If you are interested in the favicon of aWebKitWebView it’s easier to use the 
WebKitWebView: favicon property. See webkit_web_view_get_favicon() for more details. 


unstable since: 4.1 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2FaviconDatabaseClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Method 


WebKit2F aviconDatabaseclear 
Declaration 


void 
webkit_favicon_database_clear ( 

WebKitFaviconDatabase* database 
) 


Description 


Clears all icons from the database. 
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Methods 


Generated by[gi-docgen]2023.3 


Method 


WebKit | aviconDatabaseget_favicon 
Declaration 


void 

webkit_favicon_database_get_favicon ( 
WebKitFaviconDatabase* database, 
const gchar* page_uri, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously obtains a favicon image. 


Asynchronously obtains an image of the favicon for the given page URI. It returns the cached icon if it’s 
in the database asynchronously waiting for the icon to be read from the database. 


This is an asynchronous method. When the operation is finished, callback will be invoked. You can then 
call webkit_favicon_database_get_favicon_finish () to get the result of the operation. 


Parameters 
page_uri 
Type: const gchar* 
URI of the page for which we want to retrieve the favicon. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


cancellable 
Type: GCancellable 
A GCancellable or NULL. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied or NULL if you don’t care about 
the result. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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FaviconDatabase 

Methods 

get_favicon_finish 
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Method 


WebKit2FaviconDatabaseget_favicon_finish 
Declaration 


cairo_surface_t* 
webkit_favicon_database_get_favicon_finish ( 
WebKitFaviconDatabase* database, 
GAsyncResult* result, 
GError** error 


) 


Description 
Finishes an operation started with webkit_favicon_database_get_favicon(). 
Parameters 
result 
Type: GAsyncResult 


A GAsyncResult obtained from the GAsyncReadyCallback passed to 
webkit_favicon_database_get_favicon() 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 
Type: cairo_surface_t 


A new favicon image, or NULL in case of error. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit | aviconDatabaseget_favicon_uri 
Declaration 


gchar* 
webkit_favicon_database_get_favicon_uri ( 
WebKitFaviconDatabase* database, 
const gchar* page_uri 


) 


Description 
Obtains the URI of the favicon for the given page_uri. 
Parameters 
page_uri 
Type: const gchar* 
URI of the page containing the icon. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gchar* 
A newly allocated URI for the favicon, or NULL if the database doesn’t have a favicon for page_uri. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


The value is a NUL terminated UTF-8 string. 
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Signal 


WebKit2F aviconDatabase;:favicon-changed 


unstable since: 4.1 


Declaration 


void 

favicon_changed ( 
WebKitFaviconDatabase* self, 
gchar* page_uri, 
gchar* favicon_uri, 
gpointer user_data 


Description 


This signal is emitted when the favicon URI of page_uri has been changed to favicon_uri in the 
database. You can connect to this signal and call webkit_favicon_database_get_favicon () 
to get the favicon. If you are interested in the favicon of aWebKitWebView it’s easier to use the 
WebKitWebView: favicon property. See webkit_web_view_get_favicon() for more details. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 
page_uri 
Type: gchar* 
The URI of the Web page containing the icon. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


favicon_uri 
Type: gchar* 
The URI of the favicon. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 
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Properties 


selected-files 
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Class 


WebKit2FileChooserRequest 


unstable since: 4.1 


Description 


class WebKit2.FileChooserRequest : GObject.Object 
{ 
priv: WebKitFileChooserRequestPrivate* 


} 
A request to open a file chooser. 


Whenever the user interacts with an HTML input element with file type, WebKit will need to show a 
dialog to choose one or more files to be uploaded to the server along with the rest of the form data. For 
that to happen in a general way, instead of just opening a GLkFileChooserDialog (which might be 
not desirable in some cases, which could prefer to use their own file chooser dialog), WebKit will fire the 
WebKitWebView: :run-file-chooser signal with aWebKitFileChooserRequest object, 
which will allow the client application to specify the files to be selected, to inspect the details of the 
request (e.g. if multiple selection should be allowed) and to cancel the request, in case nothing 

was selected. 


In case the client application does not wish to handle this signal, WebKit will provide a default handler 
which will asynchronously run a regular GCkKFileChooserDialog for the user to interact with. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitFileChooserRequest ancestor_0 GObject ancestor_0O--this 
Ancestors 
@ GObject 


Instance methods 


webkit_file_chooser_request_cancel 


Ask WebKit to cancel the request. 


unstable since: 4.1 


webkit_file_chooser_request. 


Get the list of MIME types the file chooser dialog should handle. 


unstable since: 4.1 


webkit_file_chooser_request_get_mime_types_filter 


Get the filter currently associated with the request. 


unstable since: 4.1 


webkit_file_chooser_request_get_select_multiple 


Whether the file chooser should allow selecting multiple files. 
unstable since: 4.1 
Get the list of selected files associated to the request. 


unstable since: 4.1 


webkit_file_chooser_request_select_files 


Ask WebKit to select local files for upload and complete the request. 
unstable since: 4.1 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.FileChooserRequest:filter 


The filter currently associated with the request. See 
webkit_file_chooser_request_get_mime_types_filter() for more details. 


unstable since: 4.1 


WebKit2.FileChooser Request:mime-types 


A NULL-terminated array of strings containing the list of MIME types the file chooser dialog should 
handle. See webkit_file_chooser_request_get_mime_types () for more details. 


unstable since: 4.1 
WebKit2.FileChooserRequest:select-multiple 


Whether the file chooser should allow selecting multiple files. See 
webkit_file_chooser_request_get_select_multiple() for more details. 


unstable since: 4.1 


WebKit2.FileChooser Request:selected-files 


A NULL-terminated array of strings containing the list of selected files associated to the current request. 
See webkit_file_chooser_request_get_selected_files () for more details. 


unstable since: 4.1 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2FileChooserRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 

FileChooserRequest 

Methods 

get_selected_files 
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Method 


WebKit2FileChooserRequestcancel 
Declaration 


void 
webkit_file_chooser_request_cancel ( 


WebKitFileChooserRequest* request 
) 


Description 


Ask WebKit to cancel the request. 


It’s important to do this in case no selection has been made in the client, otherwise the request won’t be 
properly completed and the browser will keep the request pending forever, which might cause the browser 
to hang. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
FileChooserRequest 


Methods 
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Method 


WebKit2FileChooserRequestget_mime_types 
Declaration 


const gchar* const* 

webkit_file_chooser_request_get_mime_types ( 
WebKitFileChooserRequest* request 

) 


Description 


Get the list of MIME types the file chooser dialog should handle. 


Get the list of MIME types the file chooser dialog should handle, in the format specified in RFC 2046 for 
“media types’. Its contents depend on the value of the ‘accept’ attribute for HTML input elements. This 
function should normally be called before presenting the file chooser dialog to the user, to decide whether 
to allow the user to select multiple files at once or only one. 


Gets property |WebKit2.FileChooserRequest :mime-types 


Return value 


Type: An array of ut £8 


A NULL-terminated array of strings if a list of accepted MIME types is defined or NULL otherwise, 
meaning that any MIME type should be accepted. This array and its contents are owned by WebKit and 
should not be modified or freed. 


The array is NULL-terminated. 
The data is owned by the instance. 


Each element is a NUL terminated UTF-8 string. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

FileChooserRequest 

Methods 

get_selected_files 
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Method 


WebKit2FileChooserRequestget_mime_types_filter 
Declaration 


GtkFileFilter* 
webkit_file_chooser_request_get_mime_types_filter ( 


WebKitFileChooserRequest* request 
) 


Description 


Get the filter currently associated with the request. 


Get the filter currently associated with the request, ready to be used by GtkFileChooser. This function 
should normally be called before presenting the file chooser dialog to the user, to decide whether to apply 
a filter so the user would not be allowed to select files with other MIME types. 


See webkit_file_chooser_request_get_mime_types () if you are interested in getting the 
list of accepted MIME types. 


Return value 


Type: GtkFileFilter 


A GtkFileFilter ifa list of accepted MIME types is defined or NULL otherwise. The returned object 
is owned by WebKit should not be modified or freed. 


The data is owned by the instance. 
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Method 


WebKit | ileChooserRequestget_select_multiple 
Declaration 


gboolean 

webkit_file_chooser_request_get_select_multiple ( 
WebKitFileChooserRequest* request 

) 


Description 


Whether the file chooser should allow selecting multiple files. 


Determine whether the file chooser associated to this WebKitFileChooserRequest should allow 
selecting multiple files, which depends on the HTML input element having a ‘multiple’ attribute defined. 


Gets property |WebKit2.FileChooserRequest:select—multiple 


Return value 
Type: gboolean 


TRUE if the file chooser should allow selecting multiple files or FALSE otherwise. 
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API Version: 4.1 


Library Version: 2.42.4 
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FileChooserRequest 

Methods 

get_selected_files 
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Method 


WebKit | ileChooserRequestget_selected_files 
Declaration 


const gchar* const* 

webkit_file_chooser_request_get_selected_files ( 
WebKitFileChooserRequest* request 

) 


Description 


Get the list of selected files associated to the request. 


Get the list of selected files currently associated to the request. Initially, the return value of this method 
contains any files selected in previous file chooser requests for this HTML input element. Once 
webkit_file_chooser_request_select_files, the value will reflect whatever files are given. 


This function should normally be called only before presenting the file chooser dialog to the user, to 
decide whether to perform some extra action, like pre-selecting the files from a previous request. 


Gets property |WebKit2.FileChooserRequest:selected-files 


Return value 
Type: An array of ut £8 


A NULL-terminated array of strings if there are selected files associated with the request or NULL 
otherwise. This array and its contents are owned by WebKit and should not be modified or freed. 


The array is NULL-terminated. 
The data is owned by the instance. 


Each element is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 

FileChooserRequest 

Methods 

get_selected_files 
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Method 


WebKit | ileChooserRequestselect_files 
Declaration 


void 
webkit_file_chooser_request_select_files ( 
WebKitFileChooserRequest* request, 
const gchar* const* files 


) 


Description 
Ask WebKit to select local files for upload and complete the request. 
Parameters 
files 
Type: An array of gchar* 
A NULL-terminated array of strings, containing paths to local files. 
The array must be NULL-terminated. 


The data is owned by the caller of the method. 


Each element is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
FileChooserRequest! 


Properties 


selected-files 
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Property 


WebKit2FileChooserRequestpfilter 


unstable since: 4.1 


Declaration 


property filter: Gtk.FileFilter [ read ] 


Description 


The filter currently associated with the request. See 
webkit_file_chooser_request_get_mime_types_filter() for more details. 


Type: GtkFileFilter 


Available since: 4.1 


Flags 
Readable yes 
Writable no 
Construct no 


Construct only no 
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Property 


WebKit2FileChooserRequesttmime-types 


unstable since: 4.1 


Declaration 


property mime-types: string[] [ read ] 


Description 


A NULL-terminated array of strings containing the list of MIME types the file chooser dialog should 
handle. See webkit_file_chooser_request_get_mime_types () for more details. 


Type: An array of char* 


Available since: 4.1 


Getter method |webkit_file_chooser_request_get_mime_types () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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Properties 
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Property 


WebKit2FileChooserRequesttselect-multiple 


unstable since: 4.1 


Declaration 


property select-multiple: gboolean [ read ] 


Description 


Whether the file chooser should allow selecting multiple files. See 
webkit_file_chooser_request_get_select_multiple() for more details. 


Type: gboolean 


Available since: 4.1 


Default value FALSE 


Getter method |webkit_file_chooser_request_get_select_multiple() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 
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Type 


FileChooserRequest! 


Properties 
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Property 


WebKit2FileChooserRequesttselected-files 


unstable since: 4.1 


Declaration 


property selected-files: string[] [ read ] 


Description 


A NULL-terminated array of strings containing the list of selected files associated to the current request. 
See webkit_file_chooser_request_get_selected_files () for more details. 


Type: An array of char* 


Available since: 4.1 


Getter method |webkit_file_chooser_request_get_selected_files () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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Class 


W ebKit2FindController 


unstable since: 4.1 


Description 


class WebKit2.FindController : GObject.Object 
{ 


priv: WebKitFindControllerPrivate* 


} 
Controls text search in a WebKitWebView. 


A WebKitFindController is used to search text ina WebKitWebView. You can get a 
WebKitWebView‘s WebKitFindController with webkit_web_view_get_find_controller(), and 
later use it to search for text using webkit_find_controller_search(), or get the number of matches using 
webkit_find_controller_count_matches(). The operations are asynchronous and trigger signals when 
ready, such as WebKitFindController::found-text, 
WebKitFindController::failed-to-find-text or 
WebKitFindController::counted-matches. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitFindController ancestor_0 GObject ancestor_O--this 


Ancestors 


@ GObject 


Instance methods 


webkit_find_controller_count_matches 


Counts the number of matches for search_text. 

unstable since: 4.1 
[webkit_find_controller_get_max_match_count| 

Gets the maximum number of matches to report. 

unstable since: 4.1 

Gets the WebKitFindOptions for the current search. 
unstable since: 4.1 

Gets the text that find_controller is searching for. 
unstable since: 4.1 

[webkit_find_controller_get_web_view] 

Gets the WebKitWebView this find controller is associated to. 
unstable since: 4.1 

[webkit_find_controller_search] 

Looks for search_text associated with find_controller. 


unstable since: 4.1 


webkit_find_controller_search_finish 


Finishes a find operation. 

unstable since: 4.1 

Looks for the next occurrence of the search text. 
unstable since: 4.1 

Looks for the previous occurrence of the search text. 
unstable since: 4.1 

Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.FindController:max-match-count 


The maximum number of matches to report for a given search. 
unstable since: 4.1 

WebKit2.FindController:options 

The options to be used in the search operation. 

unstable since: 4.1 

WebKit2.FindController:text 

The current search text for this WebKitFindController. 
unstable since: 4.1 

WebKit2.FindController:web-view 

The WebKitWebView this controller is associated to. 


unstable since: 4.1 


Signals 
WebKit2.FindController::counted-matches 


This signal is emitted when the WebKitFindController has counted the number of matches for a 
given text after a call to webkit_find_controller_count_matches(). 


unstable since: 4.1 


WebKit2.FindController::failed-to-find-text 


This signal is emitted when a search operation does not find any result for the given text. It will be issued 
if the text is not found asynchronously after a call to webkit_find_controller_search(), 
webkit_find_controller_search_next () or webkit_find_controller_search_previous(). 


unstable since: 4.1 


WebKit2.FindController::found-text 


This signal is emitted when a given text is found in the web page text. It will be issued if the text is found 
asynchronously after a call to webkit_find_controller_search(), 
webkit_find_controller_search_next () or webkit_find_controller_search_previous(). 


unstable since: 4.1 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2FindControllerClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 


void (* _webkit_reserved2) ( 


void (* _webkit_reserved3) ( 


No description available. 
Class members 


parent_class: 
No description available. 

_webkit_reserved0: void 
No description available. 

_webkit_reservedl: void 
No description available. 

_webkit_reserved2: void 
No description available. 

_webkit_reserved3: void 
No description available. 
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Method 


WebKit2FindControllercount_matches 
Declaration 


void 
webkit_find_controller_count_matches ( 
WebKitFindController* find_controller, 
const gchar* search_text, 
guint32 find_options, 
guint max_match_count 


Description 


Counts the number of matches for search_text. 


Counts the number of matches for search_text found in the WebKitWebView with the provided 
find_options. The number of matches will be provided by the 
WebKitFindController: :counted-matches signal. 


Parameters 


search_text 


Type: const gchar* 
The text to look for. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


find_options 
Type: guint32 


A bitmask with the WebKitFindOptions used in the search. 


max_match_count 
Type: guint 


The maximum number of matches allowed in the search. 
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Method 


WebKit2FindControllerget_max_match_count 


Declaration 


guint 

webkit_find_controller_get_max_match_count ( 
WebKitFindController* find_controller 

) 


Description 


Gets the maximum number of matches to report. 


Gets the maximum number of matches to report during a text lookup. This number is passed as the last 
argument of webkit_find_controller_search () or webkit_find_controller_count_matches(). 


Gets property |WebKit2.FindController:max—match-count 


Return value 
Type: guint 


The maximum number of matches to report. 
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Method 


WebKit2FindControllerget_options 
Declaration 


guint32 
webkit_find_controller_get_options ( 

WebKitFindController* find_controller 
) 


Description 


Gets the WebKitFindOptions for the current search. 


Gets a bitmask containing the WebKit FindOptions associated with the current search. 


Gets property |WebKit2.FindController:options 


Return value 
Type: guint32 


A bitmask containing the WebKitFindOptions associated with the current search. 
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Method 


WebKit | indControllerget_search_text 
Declaration 


const gchar* 
webkit_find_controller_get_search_text ( 

WebKitFindController* find_controller 
) 


Description 


Gets the text that find_controller is searching for. 


Gets the text that find_cont roller is currently searching for. This text is passed to either 
webkit_find_controller_search() or webkit_find_controller_count_matches(). 


Return value 
Type: const gchar* 


The text to look for in the WebKitWebView. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2FindControllerget_web_view 
Declaration 


WebKitWebView* 
webkit_find_controller_get_web_view ( 

WebKitFindController* find_controller 
) 


Description 


Gets the WebKitWebView this find controller is associated to. 


Do not dereference the returned instance as it belongs to the WebKitFindController. 


Gets property |WebKit2.FindController:web-view 


Return value 


Type: 


The WebKitWebView. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
FindController 


Methods 


count_matches]get_max_match_count}get_options}get_search_text}get_web_view|search]|search_finish 
search_next]search_previous 


Generated by[gi-docgen]2023.3 
Method 


WebKit2FindControllersearch 
Declaration 


void 

webkit_find_controller_search ( 
WebKitFindController* find_controller, 
const gchar* search_text, 
guint32 find_options, 
guint max_match_count 


Description 


Looks for search_text associated with find_controller. 


Looks for search_text in the WebKitWebView associated with find_controller since the 
beginning of the document highlighting up to max_match_count matches. The outcome of the search 
will be asynchronously provided by the WebKit FindController::found-text and 
WebKitFindController: :failed-to-find-text signals. 


To look for the next or previous occurrences of the same text with the same find options use 
webkit_find_controller_search_next () and/or webkit_find_controller_search_previous(). 
The WebKitFindController will use the same text and options for the following searches unless 
they are modified by another call to this method. 


Note that if the number of matches is higher than max_match_count then 
WebKitFindController: :found-text will report G_MAXUINT matches instead of the 
actual number. 


Callers should call webkit_find_controller_search_finish () to finish the current 
search operation. 


Parameters 
search_text 
Type: const gchar* 
The text to look for. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


find_options 
Type: guint32 


A bitmask with the WebKitFindOptions used in the search. 


max_match_count 
Type: guint 


The maximum number of matches allowed in the search. 
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Method 


WebKit2FindControllersearch_finish 
Declaration 


void 
webkit_find_controller_search_finish ( 

WebKitFindController* find_controller 
) 


Description 


Finishes a find operation. 


Finishes a find operation started by webkit_find_controller_search(). It will basically unhighlight every 
text match found. 


This method will be typically called when the search UI is closed/hidden by the client application. 
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Method 


WebKit2FindControllersearch_next 
Declaration 


void 


webkit_find_controller_search_next ( 
WebKitFindController* find_controller 
) 


Description 


Looks for the next occurrence of the search text. 


Calling this method before webkit_find_controller_search() or 
webkit_find_controller_count_matches () is a programming error. 
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Method 


WebKit2FindControllersearch_previous 
Declaration 


void 


webkit_find_controller_search_previous ( 
WebKitFindController* find_controller 
) 


Description 


Looks for the previous occurrence of the search text. 


Calling this method before webkit_find_controller_search() or 
webkit_find_controller_count_matches () is a programming error. 
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Property 


WebKit2FindControllertmax-match-count 


unstable since: 4.1 


Declaration 


property max-match-count: guint [ read ] 


Description 


The maximum number of matches to report for a given search. 
Type: guint 


Available since: 4.1 


Default value 0 


Getter method |webkit_find_controller_get_max_match_count () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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FindController 
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Property 


WebKit2FindControllertoptions 


unstable since: 4.1 


Declaration 


property options: WebKit2.FindOptions [ read ] 


Description 


The options to be used in the search operation. 


Type: WebKitFindOptions 


Available since: 4.1 


Default value WEBKIT_FIND_OPTIONS_ NONE 
Getter method |webkit_find_controller_get_options () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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FindController 
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Property 


WebKit2FindControllerttext 


unstable since: 4.1 


Declaration 


property text: utf8 [ read ] 


Description 


The current search text for this WebKitFindController. 


Type: gchar* 


Available since: 4.1 
Default value NULL 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
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FindController 


Properties 
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Property 


WebKit2FindControllertweb-view 


unstable since: 4.1 


Declaration 


property web-view: WebKit2.WebView [ read, write, construct-only ] 


Description 


The WebKitWebView this controller is associated to. 


Type: 


Available since: 4.1 


Getter method |webkit_find_controller_get_web_view() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 
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Signal 


WebKit2FindControllert:counted-matches 


unstable since: 4.1 


Declaration 


void 

counted_matches ( 
WebKitFindController* self, 
guint match_count, 
gpointer user_data 


) 


Description 


This signal is emitted when the WebKitFindController has counted the number of matches for a 
given text after a call to webkit_find_controller_count_matches(). 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 
match_count 
Type: guint 


The number of matches of the search text. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
FindController 


Signals 
failed-to-find-text 


Generated by[gi-docgen|2023.3 
Signal 


WebKit2FindControllert:failed-to-find-text 


unstable since: 4.1 


Declaration 


void 

failed_to_find_text ( 
WebKitFindController* self, 
gpointer user_data 

) 


Description 


This signal is emitted when a search operation does not find any result for the given text. It will be issued 
if the text is not found asynchronously after a call to webkit_find_controller_searchQ), 
webkit_find_controller_search_next () or webkit_find_controller_search_previous(). 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
FindController 


Signals 
failed-to-find-text 


Generated by[gi-docgen|2023.3 
Signal 


WebKit2FindControllert:found-text 


unstable since: 4.1 


Declaration 


void 

found_text ( 
WebKitFindController* self, 
guint match_count, 
gpointer user_data 


) 


Description 


This signal is emitted when a given text is found in the web page text. It will be issued if the text is found 


asynchronously after a call to webkit_find_controller_search(), 


webkit_find_controller_search_next () or webkit_find_controller_search_previous(). 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 
match_count 
Type: guint 


The number of matches found of the search text. 


| 


WebKit2 
API Version: 4.1 
Library Version: 2.42.4 


Type 


FormSubmissionRequest 


Instance methods 


list_text_fields 
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Class 


WebKit2FormSubmissionRequest 


unstable since: 4.1 


Description 


class WebKit2.FormSubmissionRequest : GObject.Object 
{ 


priv: WebKitFormSubmissionRequestPrivate* 


} 
Represents a form submission request. 


When a form is about to be submitted in a WebKitWebView, the WebKitWebView: :submit-form 
signal is emitted. Its request argument contains information about the text fields of the form, that are 
typically used to store login information, returned as lists by 
webkit_form_submission_request_list_text_fields(). You can submit the form 

with webkit_form_submission_request_submit(). 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitFormSubmissionRequest ancestor_O0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 


webkit_form_submission_request_get_text_fields 


Get the values of the text fields contained in the form associated to request. 


unstable deprecated: 2.20. since: 4.1 


webkit_form_submission_request_list_text_fields 


Get lists of the text fields contained in the form associated to request. 
since: 2.20 

Continue the form submission. 

unstable since: 4.1 

Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 

struct WebKit2FormSubmissionRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 


void 


void (* _webkit_reservedl) ( 


void (* _webkit_reserved2) ( 


void (* _webkit_reserved3) 
void 


i 
} 


No description available. 
Class members 


parent_class: 
No description available. 

_webkit_reserved0: void 
No description available. 

_webkit_reservedl: void 
No description available. 

_webkit_reserved2: void 
No description available. 

_webkit_reserved3: void 
No description available. 


Content 


Description 


ierarch 


A 


ncestors 


e 
e 
e 
@ |Methods 


( 


GObjectClass 


(* 


(* 


(* 


(* 


_webkit_reserved0) 


_webkit_reservedl1) 
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void 


void 


void 
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) 


) 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


FormSubmissionRequest 


Methods 
list_text_fields 
Generated by[gi-docgen|2023.3 


Method 


WebKit2F ormSubmissionRequestget_text_fields 


deprecated: 2.20. 


Declaration 


GHashTable* 
webkit_form_submission_request_get_text_fields ( 


WebKitFormSubmissionRequest* request 


) 


Description 


Get the values of the text fields contained in the form associated to request. 


Get a GHashTabl1e with the values of the text fields contained in the form associated to request. Note 
that fields will be missing if the form contains multiple text input elements with the same name, so this 
function does not reliably return all text fields. 


Deprecated since: 2.20. 


Use webkit_form_submission_request_list_text_fields () instead. 


Return value 
Type: GHashTable 
A GHashTabl1e with the form text fields, or NULL if the form doesn’t contain text fields. 


The data is owned by the instance. 


The return value can be NULL. 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


FormSubmissionRequest 


Methods 
list_text_fields 


Generated by[gi-docgen|2023.3 
Method 


WebKit2FormSubmissionRequestlist_text_fields 


since: 2.20 


Declaration 


gboolean 
webkit_form_submission_request_list_text_fields ( 


WebKitFormSubmissionRequest* request, 
GPtrArray** field_names, 
GPtrArray** field_values 

) 


Description 


Get lists of the text fields contained in the form associated to request. 


Get lists with the names and values of the text fields contained in the form associated to request. Note 
that names and values may be NULL. 


If this function returns FALSE, then both field_names and field_values will be empty. 


Available since: 2.20 


Parameters 
field_names 
Type: An array of ut £8 
names of the text fields in the form. 
The argument will be set by the function. 
The argument can be NULL. 


The data is owned by the instance. 


Each element is a NUL terminated UTF-8 string. 


field_values 
Type: An array of ut £8 
values of the text fields in the form. 
The argument will be set by the function. 
The argument can be NULL. 


The data is owned by the instance. 


Each element is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE if the form contains text fields, or FALSE otherwise. 


| 


API Version: 4.1 


i 


Library Version: 2.42.4 


Type 

FormSubmissionRequest 

Methods 

list_text_fields 
Generated by 2023.3 


Method 


WebKit2FormSubmissionRequestsubmit 
Declaration 


void 
webkit_form_submission_request_submit ( 
WebKitFormSubmissionRequest* request 


) 


Description 


Continue the form submission. 
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API Version: 4.1 


Library Version: 2.42.4 
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Instance methods 
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Properties 
enable-high-accurac 


Signals 
stop 
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Class 


W ebKit2GeolocationManager 


since: 2.26 


Description 


class WebKit2.GeolocationManager : GObject.Object 
{ 
priv: WebKitGeolocationManagerPrivate* 


} 
Geolocation manager. 


WebKitGeolocationManager provides API to get the geographical position of the user. Once a 
WebKitGeolocationPermissionRequest is allowed, when WebKit needs to know the user 
location WebKitGeolocationManager::start signal is emitted. If the signal is handled and 
returns TRUE, the application is responsible for providing the position every time it’s updated by calling 
webkit_geolocation_manager_update_position(). The signal WebKitGeolocationManager::stop 
will be emitted when location updates are no longer needed. 


Available since: 2.26 


Hierarchy 


hierarchy this WebKitGeolocationManager ancestor_0 GObject ancestor_0--this 


Ancestors 

@ GObject 
Instance methods 
webkit_geolocation_manager_failed 
Notify manager that determining the position failed. 
since: 2.26 
Get whether high accuracy is enabled. 
since: 2.26 
[webkit_geolocation_manager_update_position] 
Notify manager that position has been updated to position. 
since: 2.26 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.GeolocationManager:enable-high-accuracy 


Whether high accuracy is enabled. This is a read-only property that will be set to TRUE when a 
WebKitGeolocationManager needs to get accurate position updates. You can connect to 
notify::enable-high-accuracy signal to monitor it. 


since: 2.26 


Signals 


WebKit2.GeolocationManager::start 


The signal is emitted to notify that manager needs to start receiving position updates. After this signal is 
emitted the user should provide the updates using 
webkit_geolocation_manager_update_position() every time the position changes, or use 
webkit_geolocation_manager_failed() incase it isn’t possible to determine the 

current position. 


since: 2.26 


WebKit2.GeolocationManager::stop 


The signal is emitted to notify that manager doesn’t need to receive position updates anymore. 
since: 2.26 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2GeolocationManagerClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 


_webkit_reserved0: void 
No description available. 
_webkit_reservedl: void 
No description available. 
_webkit_reserved2: void 
No description available. 
_webkit_reserved3: void 
No description available. 
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API Version: 4.1 


Library Version: 2.42.4 
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Methods 
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Method 


WebKit2GeolocationManagerfailed 


since: 2.26 


Declaration 


void 


webkit_geolocation_manager_failed ( 
WebKitGeolocationManager* manager, 
const char* error_message 


) 


Description 


Notify manager that determining the position failed. 
Available since: 2.26 
Parameters 
error_message 
Type: const char* 


The error message. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
failed|get_enable_high_accurac 
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Method 
WebKit J eolocationManagerget_enable_high_accuracy 
since: 2.26 


Declaration 


gboolean 
webkit_geolocation_manager_get_enable_high_accuracy ( 
WebKitGeolocationManager* manager 


) 


Description 


Get whether high accuracy is enabled. 


Available since: 2.26 


Gets property |WebKit2.GeolocationManager:enable-high-accuracy 


Return value 
Type: gboolean 


Whether the setting is enabled. 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


failed|get_enable_high_accurac 
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Method 


WebKit2GeolocationManagerupdate_position 


since: 2.26 


Declaration 


void 


webkit_geolocation_manager_update_position ( 
WebKitGeolocationManager* manager, 
WebKitGeolocationPosition* position 


) 


Description 


Notify manager that position has been updated to position. 


Available since: 2.26 


Parameters 
position 


Type:|WebKitGeolocationPosition 


A WebKitGeolocationPosition. 


The data is owned by the caller of the method. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


enable-high-accurac 
Generated by[gi-docgen|2023.3 


Property 
WebKit2GeolocationManagertenable-high-accuracy 
since: 2.26 

Declaration 

property enable-high-accuracy: gboolean [ read ] 


Description 


Whether high accuracy is enabled. This is a read-only property that will be set to TRUE when a 
WebKitGeolocationManager needs to get accurate position updates. You can connect to 
notify::enable-high-accuracy signal to monitor it. 


Type: gboolean 
Available since: 2.26 


Default value FALSE 


Getter method |webkit_geolocation_manager_get_enable_high_accuracy () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 
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WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 

Signals 


start{stop 
Generated by[gi-docgen|2023.3 
Signal 


WebKit2GeolocationManagert:start 


since: 2.26 


Declaration 


gboolean 

start ( 
WebKitGeolocationManager* self, 
gpointer user_data 


) 


Description 


The signal is emitted to notify that manager needs to start receiving position updates. After this signal is 
emitted the user should provide the updates using 
webkit_geolocation_manager_update_position() every time the position changes, or use 
webkit_geolocation_manager_failed() incase it isn’t possible to determine the 

current position. 


If the signal is not handled, WebKit will try to determine the position using GeoClue if available. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.26 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


start{stop 
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Signal 


WebKit2GeolocationManagert:stop 


since: 2.26 


Declaration 


WebKitGeolocationManager* self, 
gpointer user_data 


Description 


The signal is emitted to notify that manager doesn’t need to receive position updates anymore. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.26 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
GeolocationPermissionRequest 


Generated by 2023.3 
Class 


WebKit2\GeolocationPermissionRequest 


unstable since: 4.1 


Description 


class WebKit2.GeolocationPermissionRequest : GObject.Object 
implements WebKit2.PermissionRequest { 
priv: WebKitGeolocationPermissionRequestPrivate* 


} 
A permission request for sharing the user’s location. 


WebKitGeolocationPermissionRequest represents a request for permission to decide whether WebKit 
should provide the user’s location to a website when requested through the Geolocation API. 


When a WebKitGeolocationPermissionRequest is not handled by the user, it is denied by default. 


When embedding web views in your application, you must configure an application identifier to allow 
web content to use geolocation services. The identifier must match the name of the . desktop file which 
describes the application, sans the suffix. 


If your application uses GApplication (or any subclass like GtkApplication), WebKit will 
automatically use the identifier returned by g_application_get_application_id(). This is the recommended 
approach for enabling geolocation in applications. 


If an identifier cannot be obtained through GApplication, the value returned by g_get_prgname () 
will be used instead as a fallback. For programs which cannot use GApplication, calling 
g_set_prgname () early during initialization is needed when the name of the executable on disk does 
not match the name of a valid .desktop file. 


Available since: 4.1 


Hierarchy 
hierarchy this WebKitGeolocationPermissionRequest implements_O|WebKitPermissionRequest 


this--implements_O ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Implements 
° 
Instance methods 
Methods inherited from GObject (43) 
Please see GObject for a full list of methods. 


Methods inherited from|WebKitPermissionRequest| (2) 
webkit_permission_request_allow 


Allow the action which triggered this request. 
unstable since: 4.1 
Deny the action which triggered this request. 


unstable since: 4.1 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2GeolocationPermissionRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
\e 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void ( 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 


+ 


_webkit_reserved2) ( void ) 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
HitTestResult 


Instance methods 


context_is_editable context_is_link' context_is_ scrollbar 
context_is_selection set_link_label]get_link_title 


Properties 


link-label 
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Class 


WebKit2HitTestResult 


unstable since: 4.1 


Description 


class WebKit2.HitTestResult : GObject.Object 
{ 


priv: WebKitHitTestResultPrivate* 
} 


Result of a Hit Test. 


A Hit Test is an operation to get context information about a given point in a WebKitWebView. 
WebKitHitTestResult represents the result of a Hit Test. It provides context information about what 
is at the coordinates of the Hit Test, such as if there’s a link, an image or a media. 


You can get the context of the HitTestResult with webkit_hit_test_result_get_context () 
that returns a bitmask of WebKitHitTestResultContext flags. You can also use 
webkit_hit_test_result_context_is_linkQ, webkit_hit_test_result_context_is_image () 
and webkit_hit_test_result_context_is_media() to determine whether there’s a link, 
image or a media element at the coordinates of the Hit Test. Note that it’s possible that several 
WebKitHitTestResultContext flags are active at the same time, for example if there’s a link 


containing an image. 


When the mouse is moved over a WebKitWebView a Hit Test is performed for the mouse coordinates 
and WebKitWebView: :mouse-target-—changed signal is emitted with a 
WebKitHitTestResult. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitHitTestResult ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 


webkit_hit_test_result_context_is_editable 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_EDITABLE flag is present in 
WebKitHitTestResult:context. 


unstable since: 4.1 


webkit_hit_test_result_context_is_image 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_IMAGE flag is present in 
WebKitHitTestResult:context. 


unstable since: 4.1 


webkit_hit_test_result_context_is_link 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK flag is present in 
WebKitHitTestResult:context. 


unstable since: 4.1 


webkit_hit_test_result_context_is_media 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_MEDTA flag is present in 
WebKitHitTestResult:context. 


unstable since: 4.1 


webkit_hit_test_result_context_is_scrollbar 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_SCROLLBAR flag is present in 
WebKitHitTestResult:context. 


unstable since: 4.1 


webkit_hit_test_result_context_is_selection 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_SELECTION flag is present in 
WebKitHitTestResult:context. 


since: 2.8 
webkit_hit_test_result_get_context 
Gets the value of the WebKitHitTestResult:context property. 


unstable since: 4.1 


webkit_hit_test_result_get_image_uri 


Gets the value of the WebKitHitTestResult :image-uri property. 
unstable since: 4.1 
Gets the value of the WebKitHitTestResult:link-—label property. 


unstable since: 4.1 


webkit_hit_test_result_get_link_title 


Gets the value of the WebKitHitTestResult:link-title property. 


unstable since: 4.1 


webkit_hit_test_result_get_link_uri 


Gets the value of the WebKitHitTestResult :link—uri property. 


unstable since: 4.1 


webkit_hit_test_result_get_media_uri 


Gets the value of the WebKitHitTestResult :media-—uri property. 


unstable since: 4.1 

Methods inherited from GObject (43) 
Please see GObject for a full list of methods. 
Properties 
WebKit2.HitTestResult:context 


Bitmask of WebKitHitTestResultContext flags representing the context of the 
WebKitHitTestResult. 


unstable since: 4.1 


WebKit2.HitTestResult:image-uri 


The URI of the image if flag WEBKIT_HIT_TEST_RESULT_CONTEXT_IMAGE is present in 
WebKitHitTestResult:context. 


unstable since: 4.1 


WebKit2.HitTestResult:link-label 


The label of the link if flag WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK is present in 
WebKitHitTestResult:context. 


unstable since: 4.1 


WebKit2.HitTestResult:link-title 


The title of the link if flag WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK is present in 
WebKitHitTestResult:context. 


unstable since: 4.1 


WebKit2.HitTestResult:link-uri 


The URI of the link if flag WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK is present in 
WebKitHitTestResult:context. 


unstable since: 4.1 


WebKit2.HitTestResult:media-uri 


The URI of the media if flag WEBKIT_HIT_TEST_RESULT_CONTEXT_MEDTIA is present in 
WebKitHitTestResult:context. 


unstable since: 4.1 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2HitTestResultClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Method 


WebKit | itTestResultcontext_is_ editable 
Declaration 


gboolean 

webkit_hit_test_result_context_is_editable ( 
WebKitHitTestResult* hit_test_result 

) 


Description 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_EDITABLE flag is present in 
WebKitHitTestResult:context. 


Return value 
Type: gboolean 


TRUE if there’s an editable element at the coordinates of the hit_test_result, or FALSE otherwise. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
HitTestResult 


Methods 


context_is_editable context_is_link' context_is_ scrollbar 
context_is_selection set_link_label]get_link_title 
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Method 


WebKit | itTestResultcontext_is_image 
Declaration 


gboolean 

webkit_hit_test_result_context_is_image ( 
WebKitHitTestResult* hit_test_result 

) 


Description 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_IMAGE flag is present in 
WebKitHitTestResult:context. 


Return value 
Type: gboolean 


TRUE if there’s an image element in the coordinates of the Hit Test, or FALSE otherwise. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 
HitTestResult 


Methods 


context_is_editable context_is_link' context_is_ scrollbar 
context_is_selection set_link_label]get_link_title 
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Method 


WebKit2HitTestResultcontext_is_link 
Declaration 


gboolean 

webkit_hit_test_result_context_is_link ( 
WebKitHitTestResult* hit_test_result 

) 


Description 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK flag is present in 
WebKitHitTestResult:context. 


Return value 
Type: gboolean 


TRUE if there’s a link element in the coordinates of the Hit Test, or FALSE otherwise. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 
HitTestResult 


Methods 


context_is_editable context_is_link' context_is_ scrollbar 
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Method 


WebKit2HitTestResultcontext_is_media 
Declaration 


gboolean 

webkit_hit_test_result_context_is_media ( 
WebKitHitTestResult* hit_test_result 

) 


Description 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_MEDTA flag is present in 
WebKitHitTestResult:context. 


Return value 
Type: gboolean 


TRUE if there’s a media element in the coordinates of the Hit Test, or FALSE otherwise. 
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Method 


WebKit | itTestResultcontext_is_scrollbar 
Declaration 


gboolean 

webkit_hit_test_result_context_is_scrollbar ( 
WebKitHitTestResult* hit_test_result 

) 


Description 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_SCROLLBAR flag is present in 
WebKitHitTestResult:context. 


Return value 
Type: gboolean 


TRUE if there’s a scrollbar element at the coordinates of the hit_test_result, or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
HitTestResult 


Methods 


context_is_editable context_is_link' context_is_ scrollbar 
context_is_selection set_link_label]get_link_title 


Generated by[gi-docgen]2023.3 
Method 


WebKit | itTestResultcontext_is_selection 


since: 2.8 
Declaration 
gboolean 


webkit_hit_test_result_context_is_selection ( 
WebKitHitTestResult* hit_test_result 
) 


Description 


Gets whether WEBKIT_HIT_TEST_RESULT_CONTEXT_SELECTION flag is present in 
WebKitHitTestResult:context. 


Available since: 2.8 
Return value 
Type: gboolean 


TRUE if there’s a selected element at the coordinates of the hit_test_result, or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
HitTestResult 


Methods 


context_is_editable context_is_link' context_is_ scrollbar 
context_is_selection set_link_label]get_link_title 


Generated by[gi-docgen]2023.3 
Method 


WebKit2HitTestResultget_context 
Declaration 


guint 
webkit_hit_test_result_get_context ( 

WebKitHitTestResult* hit_test_result 
) 


Description 


Gets the value of the WebKitHitTestResult:context property. 


Gets property |WebKit2.HitTestResult:context 


Return value 
Type: guint 


A bitmask of WebKitHitTestResultContext flags. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
HitTestResult 


Methods 


context_is_editable context_is_link' context_is_ scrollbar 
context_is_selection set_link_label]get_link_title 


Generated by[gi-docgen]2023.3 
Method 


WebKit2HitTestResultget_image_uri 
Declaration 


const gchar* 
webkit_hit_test_result_get_image_uri ( 

WebKitHitTestResult* hit_test_result 
) 


Description 


Gets the value of the WebKitHitTestResult :image-uri property. 


Gets property |WebKit2.HitTestResult:image-uri 


Return value 
Type: const gchar* 


The URI of the image element in the coordinates of the Hit Test, or NULL if there isn’t an image element 
inhit_test_result context. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
HitTestResult 


Methods 


context_is_editable context_is_link' context_is_ scrollbar 
context_is_selection set_link_label]get_link_title 


Generated by[gi-docgen]2023.3 
Method 


WebKit2HitTestResultget_link_label 
Declaration 


const gchar* 
webkit_hit_test_result_get_link_label ( 

WebKitHitTestResult* hit_test_result 
) 


Description 


Gets the value of the WebKitHitTestResult:link-—label property. 


Gets property |WebKit2.HitTestResult:link—-label 


Return value 
Type: const gchar* 


The label of the link element in the coordinates of the Hit Test, or NULL if there isn’t a link element in 
hit_test_result context or the link element doesn’t have a label. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
HitTestResult 


Methods 


context_is_editable context_is_link' context_is_ scrollbar 
context_is_selection set_link_label]get_link_title 


Generated by[gi-docgen]2023.3 
Method 


WebKit2HitTestResultget_link_title 
Declaration 


const gchar* 
webkit_hit_test_result_get_link_title ( 

WebKitHitTestResult* hit_test_result 
) 


Description 


Gets the value of the WebKitHitTestResult:link—title property. 


Gets property |WebKit2.HitTestResult:link-title 


Return value 
Type: const gchar* 


The title of the link element in the coordinates of the Hit Test, or NULL if there isn’t a link element in 
hit_test_result context or the link element doesn’t have a title. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
HitTestResult 


Methods 


context_is_editable context_is_link' context_is_ scrollbar 
context_is_selection set_link_label]get_link_title 


Generated by[gi-docgen]2023.3 
Method 


WebKit2HitTestResultget_link_uri 
Declaration 


const gchar* 
webkit_hit_test_result_get_link_uri ( 

WebKitHitTestResult* hit_test_result 
) 


Description 


Gets the value of the WebKitHitTestResult :link—uri property. 


Gets property |WebKit2.HitTestResult:link-uri 


Return value 
Type: const gchar* 


The URI of the link element in the coordinates of the Hit Test, or NULL if there isn’t a link element in 
hit_test_result context. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
HitTestResult 


Methods 


context_is_editable context_is_link' context_is_ scrollbar 
context_is_selection set_link_label]get_link_title 


Generated by[gi-docgen]2023.3 
Method 


WebKit2HitTestResultget_media_uri 
Declaration 


const gchar* 
webkit_hit_test_result_get_media_uri ( 

WebKitHitTestResult* hit_test_result 
) 


Description 


Gets the value of the WebKitHitTestResult :media-—uri property. 


Gets property |WebKit2.HitTestResult:media-uri 


Return value 
Type: const gchar* 


The URI of the media element in the coordinates of the Hit Test, or NULL if there isn’t a media element in 
hit_test_result context. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
HitTestResult 


Properties 


link-label 
Generated by[gi-docgen|2023.3 


Property 


WebKit2HitTestResulttcontext 


unstable since: 4.1 


Declaration 


property context: guint [ read, write, construct-only ] 


Description 


Bitmask of WebKitHitTestResultContext flags representing the context of the 
WebKitHitTestResult. 


Type: guint 


Available since: 4.1 


Default value 0 


Getter method |webkit_hit_test_result_get_context () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
HitTestResult 


Properties 


link-label 
Generated by[gi-docgen|2023.3 


Property 


WebKit2HitTestResulttimage-uri 


unstable since: 4.1 


Declaration 


property image-uri: utf8 [ read, write, construct-only ] 


Description 


The URI of the image if flag WEBKIT_HIT_TEST_RESULT_CONTEXT_IMAGE is present in 
WebKitHitTestResult:context. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_hit_test_result_get_image_uri () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
HitTestResult 


Properties 


link-label 


Generated by[gi-docgen|2023.3 
Property 


WebKit2HitTestResulttlink-label 


unstable since: 4.1 


Declaration 


property link-label: utf8 [ read, write, construct-only ] 


Description 


The label of the link if flag WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK is present in 
WebKitHitTestResult:context. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_hit_test_result_get_link_label () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
HitTestResult 


Properties 


link-label 


Generated by[gi-docgen|2023.3 
Property 


WebKit2HitTestResulttlink-title 


unstable since: 4.1 


Declaration 


property link-title: utf8 [ read, write, construct-only ] 


Description 


The title of the link if flag WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK is present in 
WebKitHitTestResult:context. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_hit_test_result_get_link_title() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
HitTestResult 


Properties 


link-label 


Generated by[gi-docgen|2023.3 
Property 


WebKit2HitTestResulttlink-uri 


unstable since: 4.1 


Declaration 


property link-uri: utf8 [| read, write, construct-only ] 


Description 


The URI of the link if flag WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK is present in 
WebKitHitTestResult:context. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_hit_test_result_get_link_uri() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
HitTestResult 


Properties 


link-label 
Generated by[gi-docgen|2023.3 


Property 


WebKit2HitTestResulttmedia-uri 


unstable since: 4.1 


Declaration 


property media-uri: utf8 [ read, write, construct-only ] 


Description 


The URI of the media if flag WEBKIT_HIT_TEST_RESULT_CONTEXT_MEDTIA is present in 
WebKitHitTestResult:context. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_hit_test_result_get_media_uri () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Instance methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 


Properties 


Signals 
lcommitted|delete-surrounding|preedit-changed|preedit-finished|preedit-started 


Virtual methods 


delete_surrounding}filter_key_event 


notify_focus_out|notify_surrounding|preedit_changed]preedit_finished|preedit_started}reset| 
set_enable_preedit 


Generated by|gi-docgen]2023.3 
Class 


WebKit2InputMethodContext 


since: 2.28 


Description 


abstract class WebKit2.InputMethodContext : GObject.Object 
{ 

priv: WebKitInputMethodContextPrivate* 
} 


Base class for input method contexts. 


WebKitInputMethodContext defines the interface to implement WebKit input methods. The input 
methods are used by WebKit, when editable content is focused, to map from key events to Unicode 
character strings. 


An input method may consume multiple key events in sequence and finally output the composed result. 
This is called preediting, and an input method may provide feedback about this process by displaying the 
intermediate composition states as preedit text. 


Available since: 2.28 


Hierarchy 


hierarchy this WebKitInputMethodContext ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 


webkit_input_method_context_filter_key_event 


Allow key_event to be handled by the input method. 

since: 2.28 

[webkit_input_method_context_get_input_hints 

Get the value of the WebKit InputMethodContext:input-—hints property. 
since: 2.28 

[webkit_input_method_context_get_input_purpose| 

Get the value of the WebKit InputMethodContext : input-—purpose property. 
since: 2.28 

Get the pre-edit string and a list of WebKitInputMethodUnderline. 


since: 2.28 


webkit_input_method_context_notify_cursor_area 


Notify context that cursor area changed in input associated. 


since: 2.28 


webkit_input_method_context_notify_focus_in 


Notify context that input associated has gained focus. 


since: 2.28 


webkit_input_method_context_notify_focus_out 


Notify context that input associated has lost focus. 

since: 2.28 

[webkit_input_method_context_notify_surrounding] 

Notify context that the context surrounding the cursor has changed. 
since: 2.28 

Reset the context. 

since: 2.28 

[webkit_input_method_context_set_enable_preedit| 

Set whether context should enable preedit to display feedback. 


since: 2.28 


webkit_input_method_context_set_input_hints 


Set the value of the WebKit InputMethodContext:input-—hints property. 
since: 2.28 

Set the value of the WebKit InputMethodContext : input—purpose property. 
since: 2.28 

Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 
WebKit2.InputMethodContext:input-hints 
The WebKit InputHints of the input associated with this context. 


since: 2.28 


WebKit2.InputMethodContext:input-purpose 


The WebKit InputPurpose of the input associated with this context. 


since: 2.28 


Signals 
WebKit2.InputMethodContext::committed 


Emitted when a complete input sequence has been entered by the user. This can be a single character 
immediately after a key press or the final result of preediting. 


since: 2.28 


WebKit2.InputMethodContext::delete-surrounding 


Emitted when the input method wants to delete the context surrounding the cursor. If of fset isa 
negative value, it means a position before the cursor. 


since: 2.28 


WebKit2.InputMethodContext::preedit-changed 


Emitted whenever the preedit sequence currently being entered has changed. It is also emitted at the end of 
a preedit sequence, in which case webkit_input_method_context_get_preedit () returns the 
empty string. 


since: 2.28 


WebKit2.InputMethodContext::preedit-finished 


Emitted when a preediting sequence has been completed or canceled. 


since: 2.28 


WebKit2.InputMethodContext::preedit-started 


Emitted when a new preediting sequence starts. 


since: 2.28 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2InputMethodContextClass { 
GObjectClass parent_class; 
void (* preedit_started) ( 
WebKitInputMethodContext* context 
\; 
void (* preedit_changed) ( 
WebKitInputMethodContext* context 
i 
void (* preedit_finished) ( 
WebKitInputMethodContext* context 
\e 
void (* committed) ( 
WebKitInputMethodContext* context, 
const char* text 


\e 

void (* delete_surrounding) ( 
WebKitInputMethodContext* context, 
int offset, 
guint n_chars 

\; 

void (* set_enable_preedit) ( 
WebKitInputMethodContext* context, 
gboolean enabled 

i; 

void (* get_preedit) ( 
WebKitInputMethodContext* context, 
gchar** text, 
GList** underlines, 
guint* cursor_offset 

i; 

gboolean (* filter_key_event) ( 
WebKitInputMethodContext* context, 
GdkEventKey* key_event 


\e 
void (* notify_focus_in) ( 
WebKitInputMethodContext* context 
\; 
void (* notify_focus_out) ( 
WebKitInputMethodContext* context 
ie 
void (* notify_cursor_area) ( 
WebKitInputMethodContext* context, 


int x, 
int y, 
int width, 
int height 
i 
void (* notify_surrounding) ( 
WebKitInputMethodContext* context, 
const gchar* text, 
guint length, 
guint cursor_index, 
guint selection_index 
i 
void (* reset) ( 
WebKitInputMethodContext* context 
i 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 
void 
i 
void (* _webkit_reserved4) ( 
void 
i 
void (* _webkit_reserved5) ( 
void 
i 
void (* _webkit_reserved6) ( 
void 
i 
void (* _webkit_reserved7) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 

No description available. 
preedit_started: void (* preedit_started) ( WebKitInputMethodContext* 
context ) 

No description available. 
preedit_changed: void (* preedit_changed) ( WebKitInputMethodContext* 
context ) 

No description available. 


preedit_finished: void (* preedit_finished) ( WebKitInputMethodContext* 
context ) 

No description available. 
committed: void (* committed) ( WebKitInputMethodContext* context, 
const char* text ) 

No description available. 
delete_surrounding: void (* delete_surrounding) ( 
WebKitInputMethodContext* context, int offset, guint n_chars ) 

No description available. 
set_enable_preedit: void (* set_enable_preedit) ( 
WebKitInputMethodContext* context, gboolean enabled ) 

No description available. 
get_preedit: void (* get_preedit) ( WebKitInputMethodContext* context, 
gchar** text, GList** underlines, guint* cursor_offset ) 

No description available. 
filter_key_event: gboolean (* filter_key_event) ( 
WebKitInputMethodContext* context, GdkEventKey* key_event ) 

No description available. 


notify_focus_in: void (* notify_focus_in) ( WebKitInputMethodContext* 
context ) 

No description available. 
notify_focus_out: void (* notify_focus_out) ( WebKitInputMethodContext* 
context ) 


No description available. 
notify_cursor_area: void (* notify_cursor_area) ( 
WebKitInputMethodContext* context, int x, int y, int width, int height 
) 

No description available. 
notify_surrounding: void (* notify_surrounding) ( 
WebKitInputMethodContext* context, const gchar* text, guint length, 
guint cursor_index, guint selection_index ) 

No description available. 
reset: void (* reset) ( WebKitInputMethodContext* context ) 

No description available. 


_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 

_webkit_reserved4: void (* _webkit_reserved4) ( void ) 
No description available. 

_webkit_reserved5: void (* _webkit_reserved5) ( void ) 


No description available. 


_webkit_reserved6: void (* _webkit_reserved6) ( void ) 
No description available. 

_webkit_reserved7: void (* _webkit_reserved7) ( void ) 
No description available. 


Virtual methods 


WebKit2.InputMethodContextClass.committed 


No description available. 


unstable since: 4.1 


WebKit2.InputMethodContextClass.delete_surrounding 


No description available. 

unstable since: 4.1 
[WebKit2.InputMethodContextClass.filter_key_event| 
Allow key_event to be handled by the input method. 

since: 2.28 
[WebKit2.InputMethodContextClass.get_preedit] 

Get the pre-edit string and a list of WebKitInputMethodUnderline. 
since: 2.28 
[WebKit2.InputMethodContextClass.notify_cursor_areal 
Notify context that cursor area changed in input associated. 
since: 2.28 
[WebKit2.InputMethodContextClass.notify_focus_in] 
Notify context that input associated has gained focus. 
since: 2.28 

Notify context that input associated has lost focus. 


since: 2.28 


[WebKit2.nputMethodContextClass.notify_surrounding| 

Notify context that the context surrounding the cursor has changed. 
since: 2.28 

WebKit2.InputMethodContextClass.preedit_changed 

No description available. 


unstable since: 4.1 


WebKit2.InputMethodContextClass.preedit_finished 


No description available. 


unstable since: 4.1 


WebKit2.InputMethodContextClass.preedit_started 


No description available. 

unstable since: 4.1 

[WebKit2.InputMethodContextClass.reset] 

Reset the context. 

since: 2.28 

Set whether context should enable preedit to display feedback. 


since: 2.28 


Properties 


Signals 


Virtual methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 


Generated by[gi-docgen|2023.3 
Method 


WebKit | nputMethodContextfilter_key_event 


since: 2.28 


Declaration 


gboolean 

webkit_input_method_context_filter_key_event ( 
WebKitInputMethodContext* context, 
GdkEventKey* key_event 

) 


Description 


Allow key_event to be handled by the input method. 

If TRUE is returned, then no further processing should be done for the key event. 
Available since: 2.28 

Parameters 


key_event 


Type: GdkEventKey 


The key event to filter. 


The data is owned by the caller of the method. 


Return value 
Type: gboolean 


TRUE if the key event was handled, or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 


Generated by[gi-docgen|2023.3 
Method 


WebKit2InputMethodContextget_input_hints 


since: 2.28 


Declaration 


WebKitInputHints 

webkit_input_method_context_get_input_hints ( 
WebKitInputMethodContext* context 

) 


Description 


Get the value of the WebKit InputMethodContext:input-—hints property. 


Available since: 2.28 


Gets property |WebKit2.InputMethodContext:input—hints 


Return value 


Type:|WebKitInputHints 


The WebKit InputHints of the input associated with context. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 


Generated by[gi-docgen|2023.3 
Method 


WebKit2ImputMethodContextget_input_purpose 


since: 2.28 


Declaration 


WebKitInputPurpose 

webkit_input_method_context_get_input_purpose ( 
WebKitInputMethodContext* context 

) 


Description 


Get the value of the WebKit InputMethodContext : input—purpose property. 


Available since: 2.28 


Gets property |WebKit2.InputMethodContext:input—purpose 


Return value 


Type: |WebKitInputPurpose 


The WebKit InputPurpose of the input associated with context. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 


Generated by[gi-docgen|2023.3 
Method 


WebKit2InputMethodContextget_preedit 


since: 2.28 


Declaration 


void 
webkit_input_method_context_get_preedit ( 
WebKitInputMethodContext* context, 
char** text, 
GList** underlines, 
guint* cursor_offset 


Description 


Get the pre-edit string and a list of WebKitInputMethodUnderline. 


Get the current pre-edit string for the context, and a list of WebKitInputMethodUnderline to apply to 
the string. The string will be displayed inserted at cursor_offset. 


Available since: 2.28 


Parameters 
text 
Type: char** 
Location to store the preedit string. 
The argument will be set by the function. 
The argument can be set to NULL by the method. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


The value is a NUL terminated UTF-8 string. 


underlines 
Type: A list of None 
Location to store the underlines as a GList of WebKit InputMethodUnderline. 
The argument will be set by the function. 


The argument can be set to NULL by the method. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


cursor_offset 
Type: guint* 
Location to store the position of cursor in preedit string. 


The argument will be set by the function. 


The argument can be set to NULL by the method. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 
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Method 


WebKit2ImputMethodContextnotify_cursor_area 


since: 2.28 


Declaration 


void 
webkit_input_method_context_notify_cursor_area ( 
WebKitInputMethodContext* context, 
int x, 
int y, 
int width, 
int height 


Description 


Notify context that cursor area changed in input associated. 


Available since: 2.28 


Parameters 


Type: int 


The x coordinate of cursor location. 


y 

Type: int 

The y coordinate of cursor location. 
width 

Type: int 

The width of cursor area. 
height 


Type: int 


The height of cursor area. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 
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Method 


WebKit2ImputMethodContextnotify_focus_in 


since: 2.28 


Declaration 


void 

webkit_input_method_context_notify_focus_in ( 
WebKitInputMethodContext* context 

) 


Description 


Notify context that input associated has gained focus. 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 


Generated by[gi-docgen|2023.3 
Method 


WebKit | nputMethodContextnotify_focus_out 


since: 2.28 


Declaration 


void 
webkit_input_method_context_notify_focus_out ( 
WebKitInputMethodContext* context 


) 


Description 


Notify context that input associated has lost focus. 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 
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Method 


WebKit2ImputMethodContexthotify_surrounding 


since: 2.28 


Declaration 


void 


webkit_input_method_context_notify_surrounding ( 
WebKitInputMethodContext* context, 
const gchar* text, 
int length, 
guint cursor_index, 
guint selection_index 


Description 


Notify context that the context surrounding the cursor has changed. 
If there’s no selection select ion_index is the same as cursor_index. 


Available since: 2.28 


Parameters 
text 
Type: const gchar* 
Text surrounding the insertion point. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


length 
Type: int 


The length of text, or -1 if text is nul-terminated. 


cursor_index 
Type: guint 


The byte index of the insertion cursor within text. 


selection_index 
Type: guint 


The byte index of the selection cursor within text. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 


Generated by[gi-docgen|2023.3 
Method 


WebKit2InputMethodContextreset 


since: 2.28 


Declaration 


void 
webkit_input_method_context_reset ( 

WebKitInputMethodContext* context 
) 


Description 


Reset the context. 
This will typically cause the input to clear the preedit state. 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 


Generated by[gi-docgen|2023.3 
Method 


WebKit | nputMethodContextset_enable_preedit 


since: 2.28 


Declaration 


void 
webkit_input_method_context_set_enable_preedit ( 
WebKitInputMethodContext* context, 
gboolean enabled 


) 


Description 


Set whether context should enable preedit to display feedback. 
Available since: 2.28 

Parameters 

enabled 


Type: gboolean 


Whether to enable preedit. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 


Generated by[gi-docgen|2023.3 
Method 


WebKit2ImputMethodContextset_input_hints 


since: 2.28 


Declaration 


void 

webkit_input_method_context_set_input_hints ( 
WebKitInputMethodContext* context, 
WebKitInputHints hints 

) 


Description 


Set the value of the WebKit InputMethodContext:input—hints property. 


Available since: 2.28 


Sets property {WebKit2.InputMethodContext:input—-hints 


Parameters 


hints 


Type:\WebKitInputHints 


AWebKitInputHints. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Methods 


filter_key_event[get_input_hints 
notify_focus_out set_enable_preedit]set_input_hints 


Generated by[gi-docgen|2023.3 
Method 


WebKit2ImputMethodContextset_input_purpose 


since: 2.28 


Declaration 


void 

webkit_input_method_context_set_input_purpose ( 
WebKitInputMethodContext* context, 
WebKitInputPurpose purpose 

) 


Description 


Set the value of the WebKit InputMethodContext : input-—purpose property. 


Available since: 2.28 


Sets property |WebKit2.InputMethodContext:input-—purpose 


Parameters 


purpose 


Type:\(WebKitInputPurpose 


A WebKitInputPurpose. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 


Properties 


Generated by[gi-docgen|2023.3 


Property 


WebKit2ImputMethodContexttinput-hints 


since: 2.28 


Declaration 


property input-hints: WebKit2.InputHints [ read, write ] 


Description 


The WebKit InputHints of the input associated with this context. 


Type: 
Available since: 2.28 


Default value WEBKIT_INPUT_HINT_NONE 


Getter method |webkit_input_method_context_get_input_hints() 
Setter method |webkit_input_method_context_set_input_hints() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 


Properties 


Generated by[gi-docgen|2023.3 


Property 


WebKit2ImputMethodContexttinput-purpose 


since: 2.28 


Declaration 


property input-purpose: WebKit2.InputPurpose [ read, write ] 


Description 


The WebKit InputPurpose of the input associated with this context. 


Type: 
Available since: 2.28 


Default value WEBKIT_INPUT_PURPOSE_FREE_ FORM 


Getter method |webkit_input_method_context_get_input_purpose() 
Setter method webkit_input_method_context_set_input_purpose() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 
Signals 


lcommitted|delete-surrounding}preedit-changed}preedit-finished|preedit-started| 


Generated by[gi-docgen|2023.3 
Signal 


WebKit2ImputMethodContext;:committed 


since: 2.28 


Declaration 


void 

committed ( 
WebKitInputMethodContext* self, 
gchar* text, 
gpointer user_data 


) 


Description 


Emitted when a complete input sequence has been entered by the user. This can be a single character 
immediately after a key press or the final result of preediting. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.28 


Parameters 

text 
Type: gchar* 
The string result. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 
Signals 


lcommitted|delete-surrounding}preedit-changed}preedit-finished|preedit-started| 


Generated by[gi-docgen|2023.3 


Signal 

WebKit2InputMethodContextt :delete-surrounding 
since: 2.28 

Declaration 


delete_surrounding ( 
WebKitInputMethodContext* self, 
gint offset, 
guint n_chars, 
gpointer user_data 


) 


Description 


Emitted when the input method wants to delete the context surrounding the cursor. If of fset isa 
negative value, it means a position before the cursor. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.28 


Parameters 
offset 
Type: gint 


The character offset from the cursor position of the text to be deleted. 


n_chars 
Type: guint 


The number of characters to be deleted. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 
Signals 


lcommitted|delete-surrounding}preedit-changed}preedit-finished|preedit-started| 


Generated by[gi-docgen|2023.3 


Signal 
WebKit2ImputMethodContextt:preedit-changed 
since: 2.28 

Declaration 


void 

preedit_changed ( 
WebKitInputMethodContext* self, 
gpointer user_data 

) 


Description 


Emitted whenever the preedit sequence currently being entered has changed. It is also emitted at the end of 
a preedit sequence, in which case webkit_input_method_context_get_preedit () returns the 
empty string. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 


Signals 


preedit-finished 
Generated by[gi-docgen|2023.3 


Signal 
WebKit2InputMethodContextt:preedit-finished 
since: 2.28 

Declaration 


void 

preedit_finished ( 
WebKitInputMethodContext* self, 
gpointer user_data 


) 


Description 


Emitted when a preediting sequence has been completed or canceled. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 


Signals 


preedit-finished 
Generated by[gi-docgen|2023.3 


Signal 
WebKit2InputMethodContextt:preedit-started 
since: 2.28 

Declaration 


void 

preedit_started ( 
WebKitInputMethodContext* self, 
gpointer user_data 


) 


Description 


Emitted when a new preediting sequence starts. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2ImputMethodContextcommitted 


since: 2.28 


Declaration 


void 

committed ( 
WebKitInputMethodContext* context, 
const char* text 


) 


Description 


No description available. 
Available since: 2.28 
Parameters 

text 


Type: const char* 


No description available. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2ImputMethodContextdelete_surrounding 


since: 2.28 


Declaration 


void 


delete_surrounding ( 
WebKitInputMethodContext* context, 
int offset, 
guint n_chars 


) 


Description 


No description available. 


Available since: 2.28 


Parameters 


offset 


Type: int 


No description available. 


n_chars 
Type: guint 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit | nputMethodContextfilter_key_event 


since: 2.28 


Declaration 


gboolean 

filter_key_event ( 
WebKitInputMethodContext* context, 
GdkEventKey* key_event 

i 


Description 


Allow key_event to be handled by the input method. 
If TRUE is returned, then no further processing should be done for the key event. 


Available since: 2.28 


Parameters 
key_event 
Type: GdkEventKey 


The key event to filter. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE if the key event was handled, or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2InputMethodContextget_preedit 


since: 2.28 


Declaration 


void 

get_preedit ( 
WebKitInputMethodContext* context, 
gchar** text, 
GList** underlines, 
guint* cursor_offset 


Description 


Get the pre-edit string and a list of WebKitInputMethodUnderline. 


Get the current pre-edit string for the context, and a list of WebKitInputMethodUnderline to apply to 
the string. The string will be displayed inserted at cursor_offset. 


Available since: 2.28 


Parameters 
text 
Type: gchar** 
Location to store the preedit string. 
The argument will be set by the function. 
The argument can be set to NULL by the virtual function. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


The value is a NUL terminated UTF-8 string. 


underlines 
Type: A list of None 
Location to store the underlines as a GList of WebKit InputMethodUnderline. 
The argument will be set by the function. 


The argument can be set to NULL by the virtual function. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


cursor_offset 
Type: guint* 
Location to store the position of cursor in preedit string. 


The argument will be set by the function. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2ImputMethodContextnotify_cursor_area 


since: 2.28 


Declaration 


void 

notify_cursor_area ( 
WebKitInputMethodContext* context, 
int x, 
int y, 
int width, 
int height 


Description 


Notify context that cursor area changed in input associated. 


Available since: 2.28 


Parameters 


x 

Type: int 

The x coordinate of cursor location. 
y 

Type: int 

The y coordinate of cursor location. 
width 

Type: int 

The width of cursor area. 
height 


Type: int 


The height of cursor area. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2ImputMethodContextnotify_focus_in 


since: 2.28 


Declaration 


void 

notify_focus_in ( 
WebKitInputMethodContext* context 

) 


Description 


Notify context that input associated has gained focus. 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit | nputMethodContextnotify_focus_out 


since: 2.28 


Declaration 


void 

notify_focus_out ( 
WebKitInputMethodContext* context 

) 


Description 


Notify context that input associated has lost focus. 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2ImputMethodContexthotify_surrounding 


since: 2.28 


Declaration 


void 

notify_surrounding ( 
WebKitInputMethodContext* context, 
const gchar* text, 
guint length, 
guint cursor_index, 


guint selection_index 


Description 


Notify context that the context surrounding the cursor has changed. 
If there’s no selection select ion_index is the same as cursor_index. 


Available since: 2.28 


Parameters 
text 
Type: const gchar* 
Text surrounding the insertion point. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


length 
Type: guint 


The length of text, or -1 if text is nul-terminated. 


cursor_index 
Type: guint 


The byte index of the insertion cursor within text. 


selection_index 
Type: guint 


The byte index of the selection cursor within text. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2ImputMethodContextpreedit_changed 


since: 2.28 


Declaration 


void 

preedit_changed ( 
WebKitInputMethodContext* context 

) 


Description 


No description available. 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2ImputMethodContextpreedit_finished 


since: 2.28 


Declaration 


void 

preedit_finished ( 
WebKitInputMethodContext* context 

) 


Description 


No description available. 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2InputMethodContextpreedit_started 


since: 2.28 


Declaration 


void 

preedit_started ( 
WebKitInputMethodContext* context 

) 


Description 


No description available. 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2InputMethodContextreset 


since: 2.28 


Declaration 


void 
reset ( 

WebKitInputMethodContext* context 
) 


Description 


Reset the context. 
This will typically cause the input to clear the preedit state. 


Available since: 2.28 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodContext 


Virtual methods 


delete_surroundingffilter_key_event 
notify_focus_out|notify_surrounding|preedit_changed}preedit_finished|preedit_started]reset| 
set_enable_preedit 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit | nputMethodContextset_enable_preedit 


since: 2.28 


Declaration 


void 

set_enable_preedit ( 
WebKitInputMethodContext* context, 
gboolean enabled 

) 


Description 


Set whether context should enable preedit to display feedback. 
Available since: 2.28 

Parameters 

enabled 


Type: gboolean 


Whether to enable preedit. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InstallMissingMediaPluginsPermissionRequest 


Instance methods 


Generated by 2023.3 


Class 


W ebKit2InstallMissingMediaPluginsPermissionRequest 
deprecated: 2.40 since: 2.10 


Description 


class WebKit2.InstallMissingMediaPluginsPermissionRequest : GObject.Object 
implements WebKit2.PermissionRequest { 
/* No available fields */ 

} 

Previously, a permission request for installing missing media plugins. 


WebKitInstallMissingMediaPluginsPermissionRequest will no longer ever be created, so you can remove 
any code that attempts to handle it. 


Available since: 2.10 
Deprecated since: 2.40 


Please do not use it in newly written code. 


Hierarchy 


hierarchy this WebKitInstallMissingMediaPluginsPermissionRequest implements_0 


WebKitPermissionRequestjthis--implements_0 ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Implements 


@ |WebKitPermissionRequest! 


Instance methods 


webkit_install_missing_media_plugins_permission_request_get_description 


This function returns an empty string. 

deprecated: 2.40 since: 2.10 

Methods inherited from GObject (43) 

Please see GObject for a full list of methods. 

Methods inherited from|WebKitPermissionRequest| (2) 


Allow the action which triggered this request. 
unstable since: 4.1 
Deny the action which triggered this request. 


unstable since: 4.1 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2InstallMissingMediaPluginsPermissionRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
\e 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void ( 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 


+ 


_webkit_reserved2) ( void ) 


Content 


Description 


Hierarch 


mplements 


e 
e 
@ {Ancestors 
e 
e 


| = 
i=" 
ie) 
Q. 
n 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InstallMissingMediaPluginsPermissionRequest 


Methods 


Generated by[gi-docgen|2023.3 
Method 


IW ebKit2nstall Missing MediaPluginsPermissionRequestpet_description 


deprecated: 2.40 since: 2.10 


Declaration 


const gchar* 
webkit_install_missing_media_plugins_permission_request_get_description ( 
WebKitInstallMissingMediaPluginsPermissionRequest* request 


) 


Description 


This function returns an empty string. 
Available since: 2.10 

Deprecated since: 2.40 

Please do not use it in newly written code. 
Return value 


Type: const gchar* 


An empty string. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 
MediaKeySystemPermissionRequest 
Generated by[gi-docgen|2023.3 


Class 


WebKit2MediaKeySystemPermissionRequest 


unstable since: 4.1 


Description 


class WebKit2.MediakeySystemPermissionRequest : GObject.Object 
implements WebKit2.PermissionRequest { 
priv: WebKitMediakKeySystemPermissionRequestPrivate* 

} 


A permission request for using an EME Content Decryption Module. 


WebKitMediaKeySystemPermissionRequest represents a request for permission to decide whether 
WebKit should use the given CDM to access protected media when requested through the 
MediaKeySystem API. 


When a WebKitMediaKeySystemPermissionRequest is not handled by the user, it is denied by default. 


When handling this permission request the application may perform additional installation of the requested 
CDM, unless it is already present on the host system. 


Available since: 4.1 


Hierarchy 
hierarchy this WebKitMediaKeySystemPermissionRequest implements_O[WebKitPermissionRequest 


this--implements_0 ancestor_O0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Implements 
: 
Instance methods 
Methods inherited from GObject (43) 
Please see GObject for a full list of methods. 


Methods inherited from|WebKitPermissionRequest| (2) 
webkit_permission_request_allow 


Allow the action which triggered this request. 
unstable since: 4.1 
Deny the action which triggered this request. 


unstable since: 4.1 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2MediakeySystemPermissionRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 


_webkit_reserved3) 


No description available. 
Class members 


parent_class: 
No description available. 

_webkit_reserved0: void 
No description available. 

_webkit_reservedl: void 
No description available. 

_webkit_reserved2: void 
No description available. 

_webkit_reserved3: void 
No description available. 


Content 


Description 


ierarch 


iE 


e 
e 
e ncestors 
e 


= 
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( 


GObjectClass 


_webkit_reserved0) 


_webkit_reservedl1) 


_webkit_reserved2) 


_webkit_reserved3) 


void 


void 


void 


void 


) 


) 


) 


) 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
NavigationPolicyDecision 


Instance methods 


eet_frame_name]get_modifiers]get_mouse_button]get_navigation_action]get_navigation_type]get_request| 


Properties 


Generated by[gi-docgen]2023.3 


Class 


WebKit2NavigationPolicyDecision 


unstable since: 4.1 


Description 


class WebKit2.NavigationPolicyDecision : WebKit2.PolicyDecision 
{ 
priv: WebKitNavigationPolicyDecisionPrivate* 


} 
A policy decision for navigation actions. 


WebKitNavigationPolicyDecision represents a policy decision for events associated with navigations. If 
the value of WebKitNavigationPolicyDecision:mouse-—button is not 0, then the navigation 
was triggered by a mouse event. 


Available since: 4.1 


Hierarchy 
hierarchy this WebKitNavigationPolicyDecision ancestor_O|/WebKitPolicyDecision|ancestor_0--this 


ancestor_1 GObject ancestor_1--ancestor_0 


Ancestors 


@ |WebKitPolicyDecision 
@ GObject 


Instance methods 


webkit_navigation_policy_decision_get_frame_name 


Gets the value of the WebKitNavigationPolicyDecision: 


unstable deprecated: 2.40 since: 4.1 


webkit_navigation_policy_decision_get_modifiers 


Gets the value of the WebKitNavigationPolicyDecision 


unstable deprecated: 2.6 since: 4.1 


webkit_navigation_policy_decision_get_mouse_button 


Gets the value of the WebKitNavigationPolicyDecision 


unstable deprecated: 2.6 since: 4.1 


webkit_navigation_policy_decision_get_navigation_action 


Gets the value of the WebKitNavigationPolicyDecision 


since: 2.6 


webkit_navigation_policy_decision_get_navigation_type 


Gets the value of the WebKitNavigationPolicyDecision 


unstable deprecated: 2.6 since: 4.1 


webkit_navigation_policy_decision_get_request 


Gets the value of the WebKitNavigationPolicyDecision: 


unstable deprecated: 2.6 since: 4.1 


Methods inherited from|WebKitPolicyDecision|(4) 


frame-name property. 


:modifiers property. 


:mouse-—button property. 


:navigation-action property. 


:navigation-type property. 


request property. 


webkit_policy_decision_download 

Spawn a download from this decision. 

unstable since: 4.1 

WebKitResponsePolicyDecision, this would cancel the request. 
unstable since: 4.1 

Accept the action which triggered this decision. 


unstable since: 4.1 


webkit_policy_decision_use_with_policies 


Accept the navigation action and continue with provided policies. 
since: 2.30 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.NavigationPolicyDecision:frame-name 


If this navigation request targets a new frame, this property contains the name of that frame. For example 
if the decision was triggered by clicking a link with a target attribute equal to “_blank”’, this property will 
contain the value of that attribute. In all other cases, this value will be NULL. 


unstable deprecated: 2.40 since: 4.1 


WebKit2.NavigationPolicyDecision:modifiers 


If the navigation associated with this policy decision was originally triggered by a mouse event, this 
property contains a bitmask of various GdkModifierType values describing the modifiers used for that 
click. If the navigation was not triggered by a mouse event or no modifiers were active, the value of this 
property will be zero. 


unstable deprecated: 2.6 since: 4.1 


WebKit2.NavigationPolicyDecision:mouse-button 


If the navigation associated with this policy decision was originally triggered by a mouse event, this 
property contains non-zero button number of the button triggering that event. The button numbers match 
those from GDK. If the navigation was not triggered by a mouse event, the value of this property will be 0. 


unstable deprecated: 2.6 since: 4.1 


WebKit2.NavigationPolicyDecision:navigation-action 


The WebKitNavigationAction that triggered this policy decision. 


since: 2.6 


WebKit2.NavigationPolicyDecision:navigation-type 


The type of navigation that triggered this policy decision. This is useful for enacting different policies 
depending on what type of user action caused the navigation. 


unstable deprecated: 2.6 since: 4.1 


WebKit2.NavigationPolicyDecision:request 


This property contains the WebKitURIRequest associated with this navigation. 


unstable deprecated: 2.6 since: 4.1 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2NavigationPolicyDecisionClass { 
WebKitPolicyDecisionClass parent_class; 
void (* _webkit_reserved0) ( 

void 
\e 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 


void 


No description available. 


Class members 


parent_class: WebKitPolicyDecisionClass 


No description available. 
_webkit_reserved0: void 
No description available. 
_webkit_reservedl: void 
No description available. 
_webkit_reserved2: void 
No description available. 
_webkit_reserved3: void 
No description available. 


Content 


Description 


ethods 
roperties 


oO 
S 
i ss 
(e) 
> 


e 
e 
e@ {Ancestors 
e 
e 


(* _webkit_reserved0) 


(* _webkit_reservedl1) 


(* _webkit_reserved2) 


(* _webkit_reserved3) 


void 


void 


void 


void 


) 


) 


) 


) 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

NavigationPolicyDecision| 

Methods 

get_mouse_button 


Generated by[gi-docgen|2023.3 
Method 


WebKit | avigationPolicyDecisionget_frame_name 


deprecated: 2.40 


Declaration 


const gchar* 
webkit_navigation_policy_decision_get_frame_name ( 
WebKitNavigationPolicyDecision* decision 


) 


Description|[src] 
Gets the value of the WebKitNavigationPolicyDecision: frame-name property. 
Deprecated since: 2.40 


Use webkit_navigation_policy_decision_get_navigation_action () instead. 


Gets property |WebKit2.NavigationPolicyDecision: frame-name 


Return value 
Type: const gchar* 
The name of the new frame this navigation action targets or NULL. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

NavigationPolicyDecision| 

Methods 

get_mouse_button 


Generated by[gi-docgen|2023.3 
Method 


WebKit2NavigationPolicyDecisionget_modifiers 


deprecated: 2.6 


Declaration 


guint 
webkit_navigation_policy_decision_get_modifiers ( 
WebKitNavigationPolicyDecision* decision 


) 


Description|[src] 
Gets the value of the WebKitNavigationPolicyDecision:modifiers property. 
Deprecated since: 2.6 


Use webkit_navigation_policy_decision_get_navigation_action () instead. 


Gets property |WebKit2.NavigationPolicyDecision:modifiers 


Return value 
Type: guint 


The modifiers active if this decision was triggered by a mouse event. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

NavigationPolicyDecision| 

Methods 

get_mouse_button 


Generated by[gi-docgen|2023.3 
Method 


WebKit2NavigationPolicyDecisionget_mouse_button 


deprecated: 2.6 


Declaration 


guint 
webkit_navigation_policy_decision_get_mouse_button ( 
WebKitNavigationPolicyDecision* decision 


) 


Description|[src] 
Gets the value of the WebKitNavigationPolicyDecision:mouse-button property. 


Deprecated since: 2.6 


Use webkit_navigation_policy_decision_get_navigation_action () instead. 


Gets property |WebKit2.NavigationPolicyDecision:mouse-button 


Return value 
Type: guint 


The mouse button used if this decision was triggered by a mouse event or 0 otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
NavigationPolicyDecision| 
Methods 


get_mouse_button 
Generated by[gi-docgen|2023.3 


Method 


WebKit2NavigationPolicyDecisionget_navigation_action 


since: 2.6 


Declaration 


WebKitNavigationAction* 
webkit_navigation_policy_decision_get_navigation_action ( 
WebKitNavigationPolicyDecision* decision 


) 


Description 


Gets the value of the WebKitNavigationPolicyDecision:navigation-action property. 


Available since: 2.6 


Gets property |WebKit2.NavigationPolicyDecision:navigation-action 


Return value 


Type: |WebKitNavigationAction 


The WebKitNavigationAction triggering this policy decision. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

NavigationPolicyDecision| 

Methods 

get_mouse_button 


Generated by[gi-docgen|2023.3 
Method 


WebKit2NavigationPolicyDecisionget_navigation_type 


deprecated: 2.6 


Declaration 


WebKitNavigationType 
webkit_navigation_policy_decision_get_navigation_type ( 
WebKitNavigationPolicyDecision* decision 


) 


Description|[src] 
Gets the value of the WebKitNavigationPolicyDecision:navigation-type property. 
Deprecated since: 2.6 


Use webkit_navigation_policy_decision_get_navigation_action () instead. 


Gets property |WebKit2.NavigationPolicyDecision:navigation-type 


Return value 


Type:|WebKitNavigationType 


The type of navigation triggering this policy decision. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

NavigationPolicyDecision| 

Methods 

get_mouse_button 


Generated by[gi-docgen|2023.3 
Method 


WebKit2NavigationPolicyDecisionget_request 


deprecated: 2.6 


Declaration 


WebKitURIRequest* 
webkit_navigation_policy_decision_get_request ( 
WebKitNavigationPolicyDecision* decision 


) 


Description|[src] 
Gets the value of the WebKitNavigationPolicyDecision: request property. 


Deprecated since: 2.6 


Use webkit_navigation_policy_decision_get_navigation_action () instead. 


Gets property |WebKit2.NavigationPolicyDecision: request 


Return value 


Type: |WebKitURIRequest 


The URI request that is associated with this navigation. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
NavigationPolicyDecision 


Properties 


frame-name}|modifiers{mouse-button|navigation-action|navigation-type|request 


Generated by[gi-docgen|2023.3 
Property 


WebKit2NavigationPolicyDecision:frame-name 


unstable deprecated: 2.40 since: 4.1 


Declaration 


property frame-name: utf8 [ read ] 


Description 


If this navigation request targets a new frame, this property contains the name of that frame. For example 
if the decision was triggered by clicking a link with a target attribute equal to “_blank”’, this property will 
contain the value of that attribute. In all other cases, this value will be NULL. 


Type: gchar* 
Available since: 4.1 
Deprecated since: 2.40 


Use WebKitNavigationPolicyDecision:navigation-—action instead. 


Default value NULL 


Gettermethod |webkit_navigation_policy_decision_get_frame_name() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
NavigationPolicyDecision 


Properties 


frame-name}|modifiers{mouse-button|navigation-action|navigation-type|request 


Generated by[gi-docgen|2023.3 
Property 


WebKit2NavigationPolicyDecision:modifiers 


unstable deprecated: 2.6 since: 4.1 


Declaration 


property modifiers: guint [ read ] 


Description 


If the navigation associated with this policy decision was originally triggered by a mouse event, this 
property contains a bitmask of various GdkModifierType values describing the modifiers used for that 
click. If the navigation was not triggered by a mouse event or no modifiers were active, the value of this 
property will be zero. 


Type: guint 
Available since: 4.1 
Deprecated since: 2.6 


Use WebKitNavigationPolicyDecision:navigation-—action instead. 


Default value 0 


Getter method |webkit_navigation_policy_decision_get_modifiers () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
NavigationPolicyDecision 


Properties 


frame-name}|modifiers{mouse-button|navigation-action|navigation-type|request 


Generated by[gi-docgen|2023.3 
Property 


WebKit2NavigationPolicyDecision:mouse-button 


unstable deprecated: 2.6 since: 4.1 


Declaration 


property mouse-button: guint [ read ] 


Description 


If the navigation associated with this policy decision was originally triggered by a mouse event, this 
property contains non-zero button number of the button triggering that event. The button numbers match 
those from GDK. If the navigation was not triggered by a mouse event, the value of this property will be 0. 


Type: guint 
Available since: 4.1 
Deprecated since: 2.6 


Use WebKitNavigationPolicyDecision:navigation-—action instead. 


Default value 0 


Getter method |webkit_navigation_policy_decision_get_mouse_button () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
NavigationPolicyDecision 


Properties 


frame-name}|modifiers{mouse-button|navigation-action|navigation-type|request 


Generated by[gi-docgen|2023.3 


Property 
WebKit2NavigationPolicyDecision:navigation-action 
since: 2.6 

Declaration 


property navigation-action: WebKit2.NavigationAction [ read ] 


Description 


The WebKitNavigationAction that triggered this policy decision. 


Type: WebKitNavigationAction 


Available since: 2.6 


Getter 
method 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
NavigationPolicyDecision 


Properties 


frame-name}|modifiers{mouse-button|navigation-action|navigation-type|request 


Generated by[gi-docgen|2023.3 
Property 


WebKit2NavigationPolicyDecision:navigation-type 


unstable deprecated: 2.6 since: 4.1 


Declaration 


property navigation-type: WebKit2.NavigationType [ read ] 


Description 


The type of navigation that triggered this policy decision. This is useful for enacting different policies 
depending on what type of user action caused the navigation. 


Type: WebKitNavigationType 


Available since: 4.1 
Deprecated since: 2.6 


Use WebKitNavigationPolicyDecision:navigation-—action instead. 


Default value WEBKIT_NAVIGATION_TYPE_LINK_CLICKED 


Getter method |webkit_navigation_policy_decision_get_navigation_type() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
NavigationPolicyDecision 


Properties 


frame-name}|modifiers{mouse-button|navigation-action|navigation-type|request 


Generated by[gi-docgen|2023.3 
Property 


WebKit2NavigationPolicyDecision:request 


unstable deprecated: 2.6 since: 4.1 


Declaration 


property request: WebKit2.URIRequest [ read ] 


Description 


This property contains the WebKitURIRequest associated with this navigation. 


Type: WebKitURIRequest 


Available since: 4.1 


Deprecated since: 2.6 


Use WebKitNavigationPolicyDecision:navigation-—action instead. 


Getter method |webkit_navigation_policy_decision_get_request () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


Generated by[gi-docgen|2023.3 
Method 


WebKit2PolicyDecisiondownload 
Declaration 


void 
webkit_policy_decision_download ( 
WebKitPolicyDecision* decision 


) 


Description 


Spawn a download from this decision. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Methods 


Generated by[gi-docgen|2023.3 
Method 


WebKit2PolicyDecisionignore 
Declaration 


void 
webkit_policy_decision_ignore ( 
WebKitPolicyDecision* decision 


) 


Description 


WebKitResponsePolicyDecision, this would cancel the request. 


Ignore the action which triggered this decision. For instance, for a 
WebKitResponsePolicyDecision, this would cancel the request. 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
download 


Generated by[gi-docgen|2023.3 
Method 


WebKit2PolicyDecisionuse 
Declaration 


void 
webkit_policy_decision_use ( 
WebKitPolicyDecision* decision 


) 


Description 


Accept the action which triggered this decision. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Methods 


Generated by[gi-docgen|2023.3 
Method 


WebKit2PolicyDecisionuse_with_policies 


since: 2.30 


Declaration 


void 

webkit_policy_decision_use_with_policies ( 
WebKitPolicyDecision* decision, 
WebKitWebsitePolicies* policies 

) 


Description 


Accept the navigation action and continue with provided policies. 


Accept the navigation action which triggered this decision, and continue with policies affecting all 
subsequent loads of resources in the origin associated with the accepted navigation action. 


For example, a navigation decision to a video sharing website may be accepted under the priviso no 
movies are allowed to autoplay. The autoplay policy in this case would be set in the policies. 


Available since: 2.30 


Parameters 
policies 


Type:|WebKitWebsitePolicies 


A WebKitWebsitePolicies. 


The data is owned by the caller of the method. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Instance methods 


Properties 
bodyfidftaghtitle| 
Signals 
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Class 


WebKit2Notification 


since: 2.8 


Description 


class WebKit2.Notification : GObject.Object 
{ 


priv: WebKitNotificationPrivate* 


} 
Holds information about a notification that should be shown to the user. 


Available since: 2.8 


Hierarchy 


hierarchy this WebKitNotification ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 


webkit_notification_clicked 


Tells WebKit the notification has been clicked. 
since: 2.12 

[webkit_notification_close] 

Closes the notification. 

since: 2.8 

Obtains the body for the notification. 

since: 2.8 

[webkit_notification_get_id] 

Obtains the unique id for the notification. 
since: 2.8 

Obtains the tag identifier for the notification. 
since: 2.16 

[webkit_notification_get_title] 

Obtains the title for the notification. 

since: 2.8 

Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.Notification:body 


The body for the notification. 

since: 2.8 

[WebKit2.Notification:id] 

The unique id for the notification. 
since: 2.8 
[WebKit2.Notification:tag] 

The tag identifier for the notification. 
since: 2.16 
WebKit2.Notification:title 

The title for the notification. 


since: 2.8 


Signals 
WebKit2.Notification::clicked 


Emitted when a notification has been clicked. See webkit_notification_clicked(). 
since: 2.12 

WebKit2.Notification::closed 

Emitted when a notification has been withdrawn. 

since: 2.8 

Signals inherited from GObject (1) 

GObject: :notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2NotificationClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
\e 
void (* _webkit_reserved3) ( 


void 

i 

void (* _webkit_reserved4) ( 
void 

i 

void (* _webkit_reserved5) ( 
void 


i 
} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void 
No description available. 

_webkit_reserved2: void ( 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void 
No description available. 

_webkit_reserved4: void (* _webkit_reserved4) ( void 
No description available. 

_webkit_reserved5: void (* _webkit_reserved5) ( void 
No description available. 


+ 


_webkit_reserved2) ( void 


Content 
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e 
e 
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e 


@ |Signals 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
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Methods 
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Method 


WebKit2Notificationclicked 


since: 2.12 


Declaration 


void 
webkit_notification_clicked ( 
WebKitNotification* notification 


) 


Description 


Tells WebKit the notification has been clicked. 
This will emit the WebKitNotification::clicked signal. 


Available since: 2.12 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


Generated by[gi-docgen|2023.3 


Method 


WebKit2Notificationclose 


since: 2.8 


Declaration 


void 


webkit_notification_close ( 
WebKitNotification* notification 


) 


Description 


Closes the notification. 


Available since: 2.8 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


Generated by[gi-docgen|2023.3 


Method 
WebKit2Notificationget_body 
since: 2.8 


Declaration 


const gchar* 
webkit_notification_get_body ( 
WebKitNotification* notification 


) 


Description 


Obtains the body for the notification. 


Available since: 2.8 


Gets property |WebKit2.Notification:body 


Return value 
Type: const gchar* 


The body for the notification. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


Generated by[gi-docgen|2023.3 


Method 
WebKit2Notificationget_id 
since: 2.8 


Declaration 


guinté4 
webkit_notification_get_id ( 
WebKitNotification* notification 


) 


Description 


Obtains the unique id for the notification. 


Available since: 2.8 


Gets property |WebKit2.Notification:id 


Return value 
Type: guint 64 


The unique id for the notification. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


Generated by[gi-docgen|2023.3 


Method 
WebKit2Notificationget_tag 
since: 2.16 


Declaration 


const gchar* 
webkit_notification_get_tag ( 
WebKitNotification* notification 


) 


Description 


Obtains the tag identifier for the notification. 


Available since: 2.16 


Gets property |WebKit2.Notification:tag 


Return value 
Type: const gchar* 


The tag for the notification. 


The data is owned by the instance. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


Generated by[gi-docgen|2023.3 


Method 
WebKit2Notificationget_title 
since: 2.8 


Declaration 


const gchar* 
webkit_notification_get_title ( 
WebKitNotification* notification 


) 


Description 


Obtains the title for the notification. 


Available since: 2.8 


Gets property |WebKit2.Notification:title 


Return value 
Type: const gchar* 


The title for the notification. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

Properties 

bodyfidjtaghtitle| 

Generated by[gi-docgen]2023.3 

Property 
WebKit2Notification: body 
since: 2.8 

Declaration 


property body: utf8 [ read ] 


Description 


The body for the notification. 


Type: gchar* 


Available since: 2.8 


Default value NULL 


Getter method |webkit_notification_get_body () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

Properties 

bodyfid}taghtitle| 
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Property 


WebKit2Notification;id 


since: 2.8 


Declaration 


property id: guint64 [ read ] 


Description 


The unique id for the notification. 


Type: guint 64 


Available since: 2.8 


Default value 0) 


Getter method |webkit_notification_get_id() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

Properties 

bodyfidjtaghtitle| 

Generated by[gi-docgen]2023.3 

Property 
WebKit2Notificationttag 
since: 2.16 

Declaration 


property tag: utf8 [ read ] 


Description 


The tag identifier for the notification. 


Type: gchar* 
Available since: 2.16 


Default value NULL 


Getter method |webkit_notification_get_tag() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

Properties 

bodyfidjtaghtitle| 

Generated by[gi-docgen]2023.3 

Property 
WebKit2Notificationttitle 
since: 2.8 

Declaration 


property title: utf8 [ read ] 


Description 


The title for the notification. 


Type: gchar* 


Available since: 2.8 


Default value NULL 


Getter method |webkit_notification_get_title() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
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Signal 


WebKit2Notification; :clicked 


since: 2.12 


Declaration 


void 

clicked ( 
WebKitNotification* self, 
gpointer user_data 

) 


Description 


Emitted when a notification has been clicked. See webkit_notification_clicked(). 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.12 
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API Version: 4.1 


Library Version: 2.42.4 
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Signals 
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Signal 


WebKit2Notifications:closed 


since: 2.8 


Declaration 


void 

closed ( 
WebKitNotification* self, 
gpointer user_data 

) 


Description 


Emitted when a notification has been withdrawn. 


The default handler will close the notification using libnotify, if built with support for it. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.8 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 
NotificationPermissionRequest 
Generated by 2023.3 


Class 


WebKit2NotificationPermissionRequest 
since: 2.8 


Description 


class WebKit2.NotificationPermissionRequest : GObject.Object 
implements WebKit2.PermissionRequest { 
priv: WebKitNotificationPermissionRequestPrivate* 


} 
A permission request for displaying web notifications. 


WebKitNotificationPermissionRequest represents a request for permission to decide whether WebKit 
should provide the user with notifications through the Web Notification API. 


When a WebKitNotificationPermissionRequest is not handled by the user, it is denied by default. 


Available since: 2.8 


Hierarchy 
hierarchy this WebKitNotificationPermissionRequest implements_O/WebKitPermissionRequest| 


this--implements_0 ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Implements 
° 
Instance methods 
Methods inherited from GObject (43) 
Please see GObject for a full list of methods. 


Methods inherited from|WebKitPermissionRequest| (2) 
webkit_permission_request_allow 


Allow the action which triggered this request. 
unstable since: 4.1 
Deny the action which triggered this request. 


unstable since: 4.1 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2NotificationPermissionRequestClass { 
GObjectClass parent_class; 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 


Content 


Description 
Hierarch 
Ancestors 


e 
e 
e 
@ (Implements 
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Class 


WebKit20ptionMenu 


since: 2.18 


Description 


class WebKit2.OptionMenu : GObject.Object 
{ 


priv: WebKitOptionMenuPrivate* 
} 


Represents the dropdown menu of a select element in a WebKitWebView. 


When a select element in a WebKitWebView needs to display a dropdown menu, the signal 
WebKitWebView: :show-option—menu is emitted, providing a WebKitOptionMenu with the 
WebKitOptionMenulItens that should be displayed. 


Available since: 2.18 


Hierarchy 


hierarchy this WebKitOptionMenu ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 

Activates the WebKitOptionMenulItem at index in menu. 
since: 2.18 

[webkit_option_menu_close] 

Request to close a WebKit OptionMenu. 

since: 2.18 

webkit_option_menu_get_event 


Gets the GdkEvent that triggered the dropdown menu. If menu was not triggered by a user interaction, 
like a mouse click, NULL is returned. 


since: 2.40 

Returns the WebKitOptionMenulItem at index in menu. 
since: 2.18 

Gets the length of the menu. 

since: 2.18 

webkit_option_menu_select_item 

Selects the WebKitOptionMenuItem at index in menu. 
since: 2.18 


Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 
WebKit2.OptionMenu::close 


Emitted when closing a WebKit Opt ionMenzu is requested. This can happen when the user explicitly 
calls webkit_option_menu_close() or when the element is detached from the current page. 


since: 2.18 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit20OptionMenuClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 


void (* _webkit_reservedl) ( 


void (* _webkit_reserved2) ( 
void 

i 

void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 

No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 


Content 


Description 
Hierarch 


Methods 


e 
e 
@ ‘Ancestors 
e 
@ |Signals 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
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Method 


WebKit2OptionMenuactivate_item 


since: 2.18 


Declaration 


void 


webkit_option_menu_activate_item ( 
WebKitOptionMenu* menu, 
guint index 


) 


Description 


Activates the WebKitOptionMenultem at index in menu. 


Activating an item changes the value of the element making the item the active one. You are expected to 
close the menu with webkit_option_menu_close() after activating an item, calling this function 
again will have no effect. 


Available since: 2.18 


Parameters 
index 
Type: guint 


The index of the item. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
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Method 


WebKit3OptionMenurlose 


since: 2.18 


Declaration 


void 


webkit_option_menu_close ( 
WebKitOptionMenu* menu 


) 


Description 


Request to close a WebKit OptionMenu. 


This emits WebKitOptionMenu::close signal. This function should always be called to notify WebKit that 
the associated menu has been closed. If the menu is closed and neither 
webkit_option_menu_select_item() nor webkit_option_menu_activate_item() 
have been called, the element value remains unchanged. 


Available since: 2.18 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
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Method 


WebKit20OptionMenuget_event 


since: 2.40 


Declaration 


GdkEvent* 
webkit_option_menu_get_event ( 
WebKitOptionMenu* menu 


) 


Description 


Gets the GdkEvent that triggered the dropdown menu. If menu was not triggered by a user interaction, 
like a mouse click, NULL is returned. 


Available since: 2.40 


Return value 
Type: GdkEvent 


The menu event or NULL. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 
WebKit20ptionMenuget_item 
since: 2.18 


Declaration 


WebKitOptionMenuItem* 

webkit_option_menu_get_item ( 
WebKitOptionMenu* menu, 
guint index 


) 


Description 


Returns the WebKitOptionMenulItem at index in menu. 
Available since: 2.18 
Parameters 
index 
Type: guint 


The index of the item. 


Return value 


Type: |WebKitOptionMenuItem 


A WebKitOptionMenulItem of menu. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
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Method 
WebKit20OptionMenuget_n_items 
since: 2.18 


Declaration 


guint 
webkit_option_menu_get_n_items ( 
WebKitOptionMenu* menu 


) 


Description 


Gets the length of the menu. 
Available since: 2.18 
Return value 

Type: guint 


The number of WebKit Opt ionMenulItems in menu. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
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Method 


WebKit2OptionMenuselect_item 


since: 2.18 


Declaration 


void 


webkit_option_menu_select_item ( 
WebKitOptionMenu* menu, 
guint index 


) 


Description 


Selects the WebKitOptionMenuItem at index in menu. 


Selecting an item changes the text shown by the combo button, but it doesn’t change the value of the 
element. You need to explicitly activate the item with webkit_option_menu_select_item() or 
close the menu with webkit_option_menu_close() in which case the currently selected item will 
be activated. 


Available since: 2.18 


Parameters 
index 
Type: guint 


The index of the item. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


Generated by[gi-docgen|2023.3 
Signal 


WebKit20OptionMenu::close 


since: 2.18 


Declaration 


void 

close ( 
WebKitOptionMenu* self, 
gpointer user_data 


) 


Description 


Emitted when closing a WebKit Opt ionMenzu is requested. This can happen when the user explicitly 
calls webkit_option_menu_close() or when the element is detached from the current page. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.18 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Instance methods 


get_description|get_mime_info_list]get_name}get_path| 
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Class 


WebKit2Plugin 


unstable deprecated: 2.32 since: 4.1 


Description 


class WebKit2.Plugin : GObject.Object 
{ 

/* No available fields */ 
} 


Represents a plugin, enabling fine-grained control. 


This object represents a single plugin, found while scanning the various platform plugin directories. This 
object can be used to get more information about a plugin, and enable/disable it, allowing fine-grained 
control of plugins. The list of available plugins can be obtained from the WebKitWebContext, 

with webkit_web_context_get_plugins(). 


Available since: 4.1 
Deprecated since: 2.32 


Please do not use it in newly written code. 


Hierarchy 
hierarchy this WebKitPlugin ancestor_O0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 

Obtain the plugin description. 

unstable deprecated: 2.32 since: 4.1 

Get information about MIME types handled by the plugin. 
unstable deprecated: 2.32 since: 4.1 
[webkit_plugin_get_name| 

Obtain the plugin name. 

unstable deprecated: 2.32 since: 4.1 

Obtain the absolute path where the plugin is installed. 
unstable deprecated: 2.32 since: 4.1 

Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2PluginClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
\e 
void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 


Content 


Description 
Hierarch 


e 
e 
@ {Ancestors 
@ |Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


get_description|get_mime_info_list]get_name}get_path| 
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Method 


WebKit2Pluginget_description 


deprecated: 2.32 


Declaration 


const gchar* 

webkit_plugin_get_description ( 
WebKitPlugin* plugin 

) 


Description 


Obtain the plugin description. 

Deprecated since: 2.32 

Please do not use it in newly written code. 
Return value 

Type: const gchar* 


Description, as a string. 


The data is owned by the instance. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


get_description|get_mime_info_list]get_name}get_path| 
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Method 


WebKit2Pluginget_mime_info_list 


deprecated: 2.32 


Declaration 


GList* 

webkit_plugin_get_mime_info_list ( 
WebKitPlugin* plugin 

) 


Description 


Get information about MIME types handled by the plugin. 
Get information about MIME types handled by the plugin, as a list of WebKitMimeInfo. 
Deprecated since: 2.32 


Please do not use it in newly written code. 


Return value 


Type: A list of WebKitMimeInfo* 


A GList of WebKitMimeInfo. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
get_description|get_mime_info_list{get_name]get_path| 
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Method 


WebKit2Pluginget_name 


deprecated: 2.32 


Declaration 


const gchar* 

webkit_plugin_get_name ( 
WebKitPlugin* plugin 

) 


Description 


Obtain the plugin name. 

Deprecated since: 2.32 

Please do not use it in newly written code. 
Return value 

Type: const gchar* 


Name, as a String. 


The data is owned by the instance. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
get_description|get_mime_info_list{get_name]get_path| 
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Method 


WebKit2Pluginget_path 


deprecated: 2.32 


Declaration 


const gchar* 

webkit_plugin_get_path ( 
WebKitPlugin* plugin 

) 


Description 


Obtain the absolute path where the plugin is installed. 
Deprecated since: 2.32 

Please do not use it in newly written code. 

Return value 

Type: const gchar* 


Path, as a string. 


The data is owned by the instance. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


PointerLockPermissionRequest 
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Class 


WebKit2PointerLockPermissionRequest 


since: 2.28 


Description 


class WebKit2.PointerLockPermissionRequest : GObject.Object 
implements WebKit2.PermissionRequest { 
priv: WebKitPointerLockPermissionRequestPrivate* 


} 


A permission request for locking the pointer. 


WebKitPointerLockPermissionRequest represents a request for permission to decide whether WebKit can 
lock the pointer device when requested by web content. 


When a WebkKitPointerLockPermissionRequest is not handled by the user, it is allowed by default. 
Available since: 2.28 


Hierarchy 
hierarchy this WebKitPointerLockPermissionRequest implements_O|/WebKitPermissionRequest 


this--implements_O ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Implements 


@ |WebKitPermissionRequest! 


Instance methods 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Methods inherited from|WebKitPermissionRequest| (2) 
webkit_permission_request_allow 


Allow the action which triggered this request. 


unstable since: 4.1 


webkit_permission_request_deny 


Deny the action which triggered this request. 


unstable since: 4.1 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2PointerLockPermissionRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 


void (* _webkit_reservedl) ( 


void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 


void 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* 
No description available. 

_webkit_reservedl: void (* 
No description available. 

_webkit_reserved2: void (* 
No description available. 

_webkit_reserved3: void (* 
No description available. 


Content 


escription 
ierarch 
ncestors 


Implements 


_webkit_reserved0) 


_webkit_reservedl1) 


_webkit_reserved2) 


_webkit_reserved3) 


void 


void 


void 


void 


) 


) 


) 


) 
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API Version: 4.1 


Library Version: 2.42.4 


Type 


Instance methods 
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Class 


WebKit2PolicyDecision 


unstable since: 4.1 


Description 


abstract class WebKit2.PolicyDecision : GObject.Object 
{ 
priv: WebKitPolicyDecisionPrivate* 


} 
A pending policy decision. 


Often WebKit allows the client to decide the policy for certain operations. For instance, a client may want 
to open a link in a new tab, block a navigation entirely, query the user or trigger a download instead of a 
navigation. In these cases WebKit will fire the WebKitWebView: :decide-policy signal with a 
WebKitPolicyDecision object. If the signal handler does nothing, WebKit will act as if 
webkit_policy_decision_use() was called as soon as signal handling completes. To make a 
policy decision asynchronously, simply increment the reference count of the WebKitPolicyDecision 
object. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitPolicyDecision ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Descendants 


@ |WebKitNavigationPolicyDecision 
@ |(WebKitResponsePolicyDecision 


Instance methods 


webkit_policy_decision_download 


Spawn a download from this decision. 

unstable since: 4.1 

[webkit_policy_decision_ignore| 
WebKitResponsePolicyDecision, this would cancel the request. 
unstable since: 4.1 

Accept the action which triggered this decision. 


unstable since: 4.1 


webkit_policy_decision_use_with_policies 


Accept the navigation action and continue with provided policies. 
since: 2.30 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2PolicyDecisionClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 


Content 
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@ |Hierarchy| 
© |Ancestors| 
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Virtual methods 
lapplylupdate 
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Class 


WebKit2PrintCustom Widget 


deprecated: 2.40 since: 2.16 


Description 


class WebKit2.PrintCustomWidget : GObject.Object 
{ 

/* No available fields */ 
} 


Allows to embed a custom widget in print dialog. 


A WebKitPrintCustomWidget allows to embed a custom widget in the print dialog by connecting to the 
WebKitPrintOperation: :create-custom—-widget signal, creating a new 
WebKitPrintCustomWidget with webkit_print_custom_widget_new() and returning it from 
there. You can later use webkit_print_operation_run_dialog() to display the dialog. 


Unfortunately, use of custom widgets is incompatible with modern containerized application frameworks 
like Flatpak. A print dialog constructed in the application process will not have access to host printers, so 
instead it must be constructed by a desktop portal service running on the host system. Because this print 
dialog runs in a separate process, it’s not possible to attach a custom widget. 


Available since: 2.16 
Deprecated since: 2.40 


Please do not use it in newly written code. 


Hierarchy 


hierarchy this WebKitPrintCustomWidget ancestor_0 GObject ancestor_0--this 


Ancestors 
@ GObject 
Constructors 
Create anew WebKitPrintCustomWidget with given widget andtitle. 


deprecated: 2.40 since: 2.16 


Instance methods 


Return the value of WebKitPrintCustomWidget : title property. 
deprecated: 2.40 since: 2.16 
Return the value of WebKitPrintCustomWidget : widget property. 


deprecated: 2.40 since: 2.16 


Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 
WebKit2.PrintCustom Widget:title 
The title of the custom widget. 


deprecated: 2.40 since: 2.16 


WebKit2.PrintCustom Widget: widget 


The custom GtkWidget that will be embedded in the dialog. 


deprecated: 2.40 since: 2.16 


Signals 
WebKit2.PrintCustom Widget::apply 


Emitted right before the printing will start. You should read the information from the widget and update 
the content based on it if necessary. The widget is not guaranteed to be valid at a later time. 


deprecated: 2.40 since: 2.16 


WebKit2.PrintCustom Widget::update 


Emitted after change of selected printer in the dialog. The actual page setup and print settings are available 
and the custom widget can actualize itself according to their values. 


deprecated: 2.40 since: 2.16 


Signals inherited from GObject (1) 
GObject: :notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2PrintCustomWidgetClass { 
GObjectClass parent_class; 
void (* apply) ( 
WebKitPrintCustomWidget* print_custom_widget, 
GtkWidget* widget 
\; 


void (* update) ( 
WebKitPrintCustomWidget* print_custom_widget, 
GtkWidget* widget, 
GtkPageSetup* page_setup, 
GtkPrintSettings* print_settings 
e 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 
apply: void (* apply) ( WebKitPrintCustomWidget* print_custom_widget, 
GtkWidget* widget ) 
No description available. 
update: void (* update) ( WebKitPrintCustomWidget* print_custom_widget, 
GtkWidget* widget, GtkPageSetup* page_setup, GtkPrintSettings* 
print_settings ) 
No description available. 
_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 
_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 
_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 
_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 


Virtual methods 


WebKit2.PrintCustom WidgetClass.apply 


No description available. 


unstable since: 4.1 


WebKit2.PrintCustom WidgetClass.update 


No description available. 
unstable since: 4.1 


Content 


Signal 


@eeeeeee °e®e 
io) 
5 
= 
a eS 
OQ 
os 
io) 
5 
Nn 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Constructors 


new 
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Constructor 


WebKit2PrintCustomWidgetnew 


deprecated: 2.40 since: 2.16 


Declaration 


WebKitPrintCustomWidget* 
webkit_print_custom_widget_new ( 
GtkWidget* widget, 
const char* title 


) 


Description 


Create anew WebKitPrintCustomWidget with given widget andtitle. 


The widget ownership is taken and it is destroyed together with the dialog even if this object could still 
be alive at that point. You typically want to pass a container widget with multiple widgets in it. 


Available since: 2.16 
Deprecated since: 2.40 


Please do not use it in newly written code. 


Parameters 

widget 
Type: GtkWidget 
A GtkWidget. 


The data is owned by the caller of the function. 


title 
Type: const char* 


A widget'‘s title. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitPrintCustomWidget 


A new WebKitPrintOperation. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 

PrintCustom Widget 

Methods 
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Method 


WebKit2PrintCustom Widgetget_title 


deprecated: 2.40 since: 2.16 


Declaration 


const gchar* 
webkit_print_custom_widget_get_title ( 

WebKitPrintCustomWidget* print_custom_widget 
) 


Description |[src] 
Return the value of WebKitPrintCustomWidget : title property. 


Return the value of WebKitPrintCustomWidget :title property for the given 
print_custom_widget object. 


Available since: 2.16 
Deprecated since: 2.40 


Please do not use it in newly written code. 


Gets property |WebKit2.PrintCustomWidget:title 


Return value 
Type: const gchar* 
Title of the print_custom_widget. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Methods 
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Method 


WebKit2PrintCustomWidgetget_widget 


deprecated: 2.40 since: 2.16 


Declaration 


GtkWidget* 
webkit_print_custom_widget_get_widget ( 

WebKitPrintCustomWidget* print_custom_widget 
) 


Description 


Return the value of WebKitPrintCustomWidget : widget property. 


Return the value of WebKitPrintCustomWidget : widget property for the given 
print_custom_widget object. The returned value will always be valid if called from 
WebKitPrintCustomWidget: :apply or WebKitPrintCustomWidget: : update callbacks, 
but it will be NULL if called after the WebKitPrintCustomWidget: :app1]y signal is emitted. 


Available since: 2.16 
Deprecated since: 2.40 


Please do not use it in newly written code. 


Gets property |WebKit2.PrintCustomWidget : widget 


Return value 
Type: GtkWidget 


A GtkWidget. 


The data is owned by the instance. 


| 


API Version: 4.1 


i 


Library Version: 2.42.4 


Type 
PrintCustom Widget 


Properties 
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Property 


WebKit2PrintCustom Widget title 


deprecated: 2.40 since: 2.16 


Declaration 


property title: utf8 [ read, write, construct-only ] 


Description 


The title of the custom widget. 


Type: gchar* 
Available since: 2.16 
Deprecated since: 2.40 


Please do not use it in newly written code. 


Default value NULL 


Getter method |webkit_print_custom_widget_get_title() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 
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Library Version: 2.42.4 


Type 
PrintCustom Widget 


Properties 
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Property 


WebKit2PrintCustom Widget: widget 


deprecated: 2.40 since: 2.16 


Declaration 


property widget: Gtk.Widget [ read, write, construct-only ] 


Description 


The custom GtkWidget that will be embedded in the dialog. 


Type: GtkWidget 
Available since: 2.16 
Deprecated since: 2.40 


Please do not use it in newly written code. 


Getter method |webkit_print_custom_widget_get_widget () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 
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API Version: 4.1 
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Library Version: 2.42.4 


Type 
PrintCustom Widget 


Signals 
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Signal 


WebKit2PrintCustom Widget: :apply 


deprecated: 2.40 since: 2.16 


Declaration 


WebKitPrintCustomWidget* self, 
gpointer user_data 


Description 


Emitted right before the printing will start. You should read the information from the widget and update 
the content based on it if necessary. The widget is not guaranteed to be valid at a later time. 


Default handler: 

The default handler is called after the handlers added via g_signal_connect (). 
Available since: 2.16 

Deprecated since: 2.40 


Please do not use it in newly written code. 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 
PrintCustom Widget 


Signals 
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Signal 


WebKit2PrintCustom Widget; :update 


deprecated: 2.40 since: 2.16 


Declaration 


void 

update ( 
WebKitPrintCustomWidget* self, 
GtkPageSetup* page_setup, 
GtkPrintSettings* print_settings, 
gpointer user_data 


Description 


Emitted after change of selected printer in the dialog. The actual page setup and print settings are available 
and the custom widget can actualize itself according to their values. 


Default handler: 

The default handler is called after the handlers added via g_signal_connect (). 
Available since: 2.16 

Deprecated since: 2.40 


Please do not use it in newly written code. 


Parameters 
page_setup 
Type: GtkPageSetup 


Actual page setup. 


The data is owned by the caller of the function. 


print_settings 
Type: GtkPrintSettings 


Actual print settings. 


The data is owned by the caller of the function. 
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Type 
PrintCustom Widget 


Virtual methods 
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Virtual Method 


WebKit2PrintCustomWidgetapply 


since: 2.16 


Declaration 


WebKitPrintCustomWidget* print_custom_widget, 
GtkWidget* widget 


Description 


No description available. 
Available since: 2.16 
Parameters 
widget 

Type: GtkWidget 


No description available. 


The data is owned by the caller of the function. 
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PrintCustom Widget 

Virtual methods 
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Virtual Method 


WebKit2PrintCustomWidgetupdate 


since: 2.16 


Declaration 


void 
update ( 
WebKitPrintCustomWidget* print_custom_widget, 
GtkWidget* widget, 
GtkPageSetup* page_setup, 
GtkPrintSettings* print_settings 
) 


Description 


No description available. 
Available since: 2.16 
Parameters 

widget 


Type: GtkWidget 


No description available. 


The data is owned by the caller of the function. 


page_setup 
Type: GtkPageSetup 


No description available. 


The data is owned by the caller of the function. 


print_settings 
Type: GtkPrintSettings 


No description available. 


The data is owned by the caller of the function. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Constructors 


Instance methods 


get_print_settings set_print_settings 


Properties 
page-setup|print-settings]web-view 
Signals 


failed[finished 
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Class 


WebKit2PrintOperation 


unstable since: 4.1 


Description 


class WebKit2.PrintOperation : GObject.Object 
{ 
priv: WebKitPrintOperationPrivate* 


} 
Controls a print operation. 


A WebKitPrintOperation controls a print operation in WebKit. With a similar API to 
GtkPrintOperation, it lets you set the print settings with 
webkit_print_operation_set_print_settings () or display the print dialog 
with webkit_print_operation_run_dialog(). 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitPrintOperation ancestor_0 GObject ancestor_O--this 


Ancestors 


@ GObject 


Constructors 
webkit_print_operation_new 
Create anew WebKitPrintOperation to print web_view contents. 


unstable since: 4.1 


Instance methods 
webkit_print_operation_get_page_setup 
Return the current page setup of print_operation. 


unstable since: 4.1 


webkit_print_operation_get_print_settings 


Return the current print settings of print_operation. 
unstable since: 4.1 

Start a print operation using current print settings and page setup. 
unstable since: 4.1 

Run the print dialog and start printing. 

unstable since: 4.1 


Set the current page setup of print_operation. 


unstable since: 4.1 


Set the current print settings of print_operation. 
unstable since: 4.1 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


The initial G¢kPageSetup for the print operation. 
unstable since: 4.1 

The initial G¢kPrintSettings for the print operation. 
unstable since: 4.1 

The WebKitWebView that will be printed. 


unstable since: 4.1 


Signals 


WebKit2.PrintOperation::create-custom-widget 


Emitted when displaying the print dialog with webkit_print_operation_run_dialog(). The returned 
WebKitPrintCustomWidget will be added to the print dialog and it will be owned by the 
print_operation. However, the object is guaranteed to be alive until the 
WebKitPrintCustomWidget::apply is emitted. 


deprecated: 2.40 since: 2.16 
WebKit2.PrintOperation::failed 


Emitted when an error occurs while printing. The given error, of the domain 
WEBKIT_PRINT_ERROR, contains further details of the failure. The 
WebKitPrintOperation: : finished signal is emitted after this one. 


unstable since: 4.1 


WebKit2.PrintOperation::finished 


Emitted when the print operation has finished doing everything required for printing. 
unstable since: 4.1 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2PrintOperationClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 


void (* _webkit_reservedl) ( 


void (* _webkit_reserved2) ( 
void 

i 

void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Constructors 
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Constructor 


WebKit2PrintOperationnew 
Declaration 


WebKitPrintOperation* 
webkit_print_operation_new ( 
WebKitWebView* web_view 


) 


Description 


Create anew WebKitPrintOperation to print web_view contents. 


Parameters 


web_view 


Type: 


A WebKitWebView. 


The data is owned by the caller of the function. 


Return value 


Type: |WebKitPrintOperation 


A new WebKitPrintOperation. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


get_print_settings set_print_settings 
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Method 


WebKit2PrintOperationget_page_setup 
Declaration 


GtkPageSetup* 
webkit_print_operation_get_page_setup ( 

WebKitPrintOperation* print_operation 
) 


Description 


Return the current page setup of print_operation. 


It returns NULL until either webkit_print_operation_set_page_setup() or 
webkit_print_operation_run_dialog() have been called. 


Gets property |WebKit2.PrintOperation:page-setup 


Return value 
Type: GtkPageSetup 


The current GtkPageSetup of print_operation. 


The data is owned by the instance. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


get_print_settings set_print_settings 
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Method 


WebKit2PrintOperationget_print_settings 
Declaration 


GtkPrintSettings* 
webkit_print_operation_get_print_settings ( 
WebKitPrintOperation* print_operation 


) 


Description 


Return the current print settings of print_operation. 


It returns NULL until either webkit_print_operation_set_print_settings() or 
webkit_print_operation_run_dialog/() have been called. 


Gets property |WebKit2.PrintOperation:print—settings 


Return value 
Type: GtkPrintSettings 


The current GtkPrintSettings of print_operation. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

PrintOperation 

Methods 

get_print_settings set_print_settings 
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Method 


WebKit2PrintOperationprint 
Declaration 


void 
webkit_print_operation_print ( 
WebKitPrintOperation* print_operation 


) 


Description 


Start a print operation using current print settings and page setup. 


Start a print operation using current print settings and page setup without showing the print dialog. If 
either print settings or page setup are not set with 
webkit_print_operation_set_print_settings() and 
webkit_print_operation_set_page_setup(Q), the default options will be used and the print job will be sent to 
the default printer. The WebKitPrintOperation: : finished signal is emitted when the printing 
operation finishes. If an error occurs while printing the signal WebKitPrintOperation: :failedis 
emitted before WebKitPrintOperation: : finished. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

PrintOperation 

Methods 

get_print_settings set_print_settings 
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Method 


WebKit2PrintOperationrun_dialog 
Declaration 


WebKitPrintOperationResponse 

webkit_print_operation_run_dialog ( 
WebKitPrintOperation* print_operation, 
GtkWindow* parent 

) 


Description 


Run the print dialog and start printing. 


Run the print dialog and start printing using the options selected by the user. This method returns when the 
print dialog is closed. If the print dialog is cancelled 
WEBKIT_PRINT_OPERATION_RESPONSE_CANCEL is returned. If the user clicks on the print button, 
WEBKIT_PRINT_OPERATION_RESPONSE_PRINT is returned and the print operation starts. In this 
case, the WebKitPrintOperation: : finished signal is emitted when the operation finishes. If an 
error occurs while printing, the signal WebKitPrintOperation: : failed is emitted before 
WebKitPrintOperation: : finished. If the print dialog is not cancelled current print settings and 
page setup of print_operation are updated with options selected by the user when Print button is 
pressed in print dialog. You can get the updated print settings and page setup by calling 
webkit_print_operation_get_print_settings() and 
webkit_print_operation_get_page_setup () after this method. 


Parameters 
parent 
Type: GtkWindow 


Transient parent of the print dialog. 


The argument can be NULL. 


The data is owned by the caller of the method. 


Return value 


Type: |WebKitPrintOperationResponse 


The WebKitPrintOperationResponse of the print dialog. 


| 


WebKit2 
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Library Version: 2.42.4 


Type 

PrintOperation 

Methods 

get_print_settings set_print_settings 
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Method 


WebKit2PrintOperationset_page_setup 
Declaration 


void 

webkit_print_operation_set_page_setup ( 
WebKitPrintOperation* print_operation, 
GtkPageSetup* page_setup 

) 


Description 


Set the current page setup of print_operation. 


Current page setup is used for the initial values of the print dialog when 
webkit_print_operation_run_dialog() is called. 


Sets property |WebKit2.PrintOperation:page-setup 


Parameters 
page_setup 


Type: GtkPageSetup 


A GtkPageSetup to set. 


The data is owned by the caller of the method. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 

PrintOperation 

Methods 

get_print_settings set_print_settings 
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Method 


WebKit2PrintOperationset_print_settings 
Declaration 


void 

webkit_print_operation_set_print_settings ( 
WebKitPrintOperation* print_operation, 
GtkPrintSettings* print_settings 

) 


Description 


Set the current print settings of print_operation. 


Set the current print settings of print_operation. Current print settings are used for the initial values 
of the print dialog when webkit_print_operation_run_dialog() is called. 


Sets property |WebKit2.PrintOperation:print-—settings 


Parameters 
print_settings 


Type: GtkPrintSettings 


A GtkPrintSettings to set. 


The data is owned by the caller of the method. 
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Properties 
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Property 


WebKit2PrintOperationtpage-setup 


unstable since: 4.1 


Declaration 


property page-setup: Gtk.PageSetup [ read, write ] 


Description 


The initial G¢kPageSetup for the print operation. 


Type: GtkPageSetup 


Available since: 4.1 


Getter method |webkit_print_operation_get_page_setup () 


Setter method webkit_print_operation_set_page_setup () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


no 
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API Version: 4.1 
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Type 


Properties 
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Property 


WebKit2PrintOperationtprint-settings 


unstable since: 4.1 


Declaration 


property print-settings: Gtk.PrintSettings [ read, write ] 


Description 


The initial G¢kPrintSettings for the print operation. 


Type: GtkPrintSettings 


Available since: 4.1 


Getter method |webkit_print_operation_get_print_settings () 
Setter method |webkit_print_operation_set_print_settings() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


no 
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API Version: 4.1 
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Properties 


Generated by[gi-docgen|2023.3 


Property 


WebKit2PrintOperationt web-view 


unstable since: 4.1 


Declaration 


property web-view: WebKit2.WebView [ read, write, construct-only ] 


Description 


The WebKitWebView that will be printed. 


Type: 


Available since: 4.1 


Flags 
Readable yes 
Writable yes 
Construct no 


Construct only yes 
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Signal 


WebKit2PrintOperationt :create-custom-widget 


deprecated: 2.40 since: 2.16 


Declaration 


WebKitPrintCustomWidget* 

create_custom_widget ( 
WebKitPrintOperation* self, 
gpointer user_data 

) 


Description 


Emitted when displaying the print dialog with webkit_print_operation_run_dialog(). The returned 
WebKitPrintCustomWidget will be added to the print dialog and it will be owned by the 
print_operation. However, the object is guaranteed to be alive until the 
WebKitPrintCustomWidget::apply is emitted. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 
Available since: 2.16 
Deprecated since: 2.40 


Please do not use it in newly written code. 


Return value 


Type: |WebKitPrintCustomWidget 


A WebKitPrintCustomWidget that will be embedded in the dialog. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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Library Version: 2.42.4 
Type 


Signals 
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Signal 


WebKit2PrintOperationt :failed 


unstable since: 4.1 


Declaration 


void 

failed ( 
WebKitPrintOperation* self, 
GError* error, 
gpointer user_data 


) 


Description 


Emitted when an error occurs while printing. The given error, of the domain 
WEBKIT_PRINT_ERROR, contains further details of the failure. The 
WebKitPrintOperation: : finished signal is emitted after this one. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 
error 
Type: GError 


The GError that was triggered. 


The data is owned by the caller of the function. 
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Signals 
failed|finished 
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Signal 


WebKit2PrintOperationt :finished 


unstable since: 4.1 


Declaration 


void 

finished ( 
WebKitPrintOperation* self, 
gpointer user_data 

) 


Description 


Emitted when the print operation has finished doing everything required for printing. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 
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Properties 
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Class 


WebKit2ResponsePolicy Decision 


unstable since: 4.1 


Description 


class WebKit2.ResponsePolicyDecision : WebKit2.PolicyDecision 
{ 
priv: WebKitResponsePolicyDecisionPrivate* 


} 
A policy decision for resource responses. 


WebKitResponsePolicyDecision represents a policy decision for a resource response, whether from the 
network or the local system. A very common use case for these types of decision is deciding whether or 
not to download a particular resource or to load it normally. 


Available since: 4.1 


Hierarchy 
hierarchy this WebKitResponsePolicyDecision ancestor_O|WebKitPolicyDecision}ancestor_O--this 


ancestor_1 GObject ancestor_1--ancestor_0 


Ancestors 


@ |WebKitPolicyDecision 
@ GObject 


Instance methods 


webkit_response_policy_decision_get_request| 


Return the WebKitURIRequest associated with the response decision. 
unstable since: 4.1 
Gets the value of the WebKitResponsePolicyDecision: response property. 


unstable since: 4.1 


webkit_response_policy_decision_is_main_frame_main_resource 


Gets whether the request is the main frame main resource. 


since: 2.40 


webkit_response_policy_decision_is_mime_type_supported 


Gets whether the MIME type of the response can be displayed in the WebKitWebView. 
since: 2.4 
Methods inherited from (4) 


Spawn a download from this decision. 
unstable since: 4.1 
WebKitResponsePolicyDecision, this would cancel the request. 


unstable since: 4.1 


webkit_policy_decision_use 
Accept the action which triggered this decision. 


unstable since: 4.1 


webkit_policy_decision_use_with_policies 


Accept the navigation action and continue with provided policies. 
since: 2.30 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.ResponsePolicyDecision:request 


This property contains the WebKitURIRequest associated with this policy decision. 


unstable since: 4.1 


WebKit2.ResponsePolicyDecision:response 


This property contains the WebKitURIResponse associated with this policy decision. 


unstable since: 4.1 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2ResponsePolicyDecisionClass { 
WebKitPolicyDecisionClass parent_class; 
void (* _webkit_reserved0) ( 

void 


void (* _webkit_reservedl) ( 


void (* _webkit_reserved2) ( 


void (* _webkit_reserved3) 
void 


i 
} 


No description available. 
Class members 


parent_class: 
No description available. 

_webkit_reserved0: void 
No description available. 

_webkit_reservedl: void 
No description available. 

_webkit_reserved2: void 
No description available. 

_webkit_reserved3: void 
No description available. 
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Method 


WebKitResponsePolicyDecisionget_request 
Declaration 


WebKitURIRequest* 
webkit_response_policy_decision_get_request ( 
WebKitResponsePolicyDecision* decision 


) 


Description 


Return the WebKitURIRequest associated with the response decision. 


Modifications to the returned object are not taken into account when the request is sent over the network, 
and is intended only to aid in evaluating whether a response decision should be taken or not. To modify 
requests before they are sent over the network the WebKitPage: :send-request signal can be 
used instead. 


Gets property |WebKit2.ResponsePolicyDecision: request 


Return value 


Type: |WebKitURIRequest 


The URI request that is associated with this policy decision. 


The data is owned by the instance. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
ResponsePolicyDecision 
Methods 
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Method 


WebKit2ResponsePolicyDecision 
Declaration 


WebKitURIResponse* 
webkit_response_policy_decision_get_response ( 
WebKitResponsePolicyDecision* decision 


vet_response 


) 


Description 


Gets the value of the WebKitResponsePolicyDecision: response property. 


Gets property |WebKit2.ResponsePolicyDecision: response 


Return value 


Type: |WebKitURIResponse 


The URI response that is associated with this policy decision. 


The data is owned by the instance. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
ResponsePolicyDecision 


Methods 


get_request|get_responsefis_main_frame_main_resource]is_mime_type_supported 
Generated by|gi-docgen}2023.3 


Method 


WebKit2ResponsePolicyDecisionis_main_frame_main_resource 


since: 2.40 


Declaration 


gboolean 
webkit_response_policy_decision_is_main_frame_main_resource ( 
WebKitResponsePolicyDecision* decision 


) 


Description 


Gets whether the request is the main frame main resource. 
Available since: 2.40 

Return value 

Type: gboolean 


TRUE if the request is the main frame main resouce or FALSE otherwise. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
ResponsePolicyDecision 
Methods 
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Method 


WebKit2ResponsePolicyDecisionis_mime_type_supported 


since: 2.4 


Declaration 


gboolean 
webkit_response_policy_decision_is_mime_type_supported ( 
WebKitResponsePolicyDecision* decision 


) 


Description 


Gets whether the MIME type of the response can be displayed in the WebKitWebView. 


Gets whether the MIME type of the response can be displayed in the WebKit WebView that triggered this 
policy decision request. See also webkit_web_view_can_show_mime_type(). 


Available since: 2.4 
Return value 
Type: gboolean 


TRUE if the MIME type of the response is supported or FALSE otherwise. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
ResponsePolicyDecision 


Properties 
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Property 


WebKit2ResponsePolicyDecision:request 


unstable since: 4.1 


Declaration 


property request: WebKit2.URIRequest [ read ] 


Description 


This property contains the WebKitURIRequest associated with this policy decision. 


Type: WebKitURIRequest 


Available since: 4.1 


Getter method |webkit_response_policy_decision_get_request () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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Type 
ResponsePolicyDecision 


Properties 
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Property 


WebKitResponsePolicyDecision:response 


unstable since: 4.1 


Declaration 


property response: WebKit2.URIResponse [ read ] 


Description 


This property contains the WebKitURIResponse associated with this policy decision. 


Type: WebKitURIResponse 


Available since: 4.1 


Getter method |webkit_response_policy_decision_get_response() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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Class 


WebKit2SecurityManager 


unstable since: 4.1 


Description 


class WebKit2.SecurityManager : GObject.Object 
{ 


priv: WebKitSecurityManagerPrivate* 


} 


Controls security settings ina WebKitWebContext. 


The WebKitSecurityManager defines security settings for URI schemes in a 
WebKitWebContext. Get it from the context with webkit_web_context_get_security_manager(), and 
use it to register a URI scheme with a certain security level, or to check if it already has it. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitSecurityManager ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 


webkit_security_manager_register_uri_scheme_as_cors_enabled 


Register scheme as a CORS (Cross-origin resource sharing) enabled scheme. 


unstable since: 4.1 


webkit_security_manager_register_uri_scheme_as_display_isolated 


Register scheme as a display isolated scheme. 


unstable since: 4.1 


webkit_security_manager_register_uri_scheme_as_empty_document 


Register scheme as an empty document scheme. 


unstable since: 4.1 


webkit_security_manager_register_uri_scheme_as_local 


Register scheme as a local scheme. 


unstable since: 4.1 


webkit_security_manager_register_uri_scheme_as_no_access 


Register scheme as a no-access scheme. 


unstable since: 4.1 


webkit_security_manager_register_uri_scheme_as_secure 


Register scheme as a secure scheme. 


unstable since: 4.1 


webkit_security_manager_uri_scheme_is_cors_enabled 


Whether scheme is considered as a CORS enabled scheme. 


unstable since: 4.1 


webkit_security_manager_uri_scheme_is_display_isolated 


Whether scheme is considered as a display isolated scheme. 


unstable since: 4.1 


webkit_security_manager_uri_scheme_is_empty_document 


Whether scheme is considered as an empty document scheme. 


unstable since: 4.1 


webkit_security_manager_uri_scheme_is_local 


Whether scheme is considered as a local scheme. 


unstable since: 4.1 


webkit_security_manager_uri_scheme_is_no_access 


Whether scheme is considered as a no-access scheme. 


unstable since: 4.1 


webkit_security_manager_uri_scheme_is_secure 


Whether scheme is considered as a secure scheme. 
unstable since: 4.1 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2SecurityManagerClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Method 


WebKit2SecurityManagerregister_uri_scheme_as_cors_enabled 
Declaration 


void 
webkit_security_manager_register_uri_scheme_as_cors_enabled ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Register scheme as a CORS (Cross-origin resource sharing) enabled scheme. 

This means that CORS requests are allowed. See W3C CORS specification http://www.w3.org/TR/cors/. 
Parameters 

scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Methods 


register_uri_scheme_as_cors_enabled|register_uri_scheme_as_display_isolated| 
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Method 


WebKit2SecurityManagerfegister_uri_scheme_as_display_isolated 
Declaration 


void 
webkit_security_manager_register_uri_scheme_as_display_isolated ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Register scheme as a display isolated scheme. 

This means that pages cannot display these URIs unless they are from the same scheme. 
Parameters 

scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Library Version: 2.42.4 
Type 
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Method 


WebKit2SecurityManagerfegister_uri_scheme_as_empty_document 
Declaration 


void 
webkit_security_manager_register_uri_scheme_as_empty_document ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Register scheme as an empty document scheme. 

This means that they are allowed to commit synchronously. 
Parameters 

scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


register_uri_scheme_as_cors_enabled|register_uri_scheme_as_display_isolated| 
register_uri_scheme_as_empty_documentfregister_uri_scheme_as_locall 
luri_scheme_is_display_isolatedjuri_scheme_is_empty_documentjuri_scheme_is_locall 
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Method 


WebKit2SecurityManagerregister_uri_scheme_as_local 
Declaration 


void 


webkit_security_manager_register_uri_scheme_as_local ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Register scheme as a local scheme. 

This means that other non-local pages cannot link to or access URIs of this scheme. 
Parameters 

scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


register_uri_scheme_as_cors_enabled|register_uri_scheme_as_display_isolated| 
register_uri_scheme_as_empty_documentfregister_uri_scheme_as_locall 
luri_scheme_is_display_isolatedjuri_scheme_is_empty_documentjuri_scheme_is_locall 


Generated by[gi-docgen]2023.3 
Method 


WebKit 8 ecurity Managerregister_uri_scheme_as_no_access 
Declaration 


void 
webkit_security_manager_register_uri_scheme_as_no_access ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Register scheme as a no-access scheme. 


This means that pages loaded with this URI scheme cannot access pages loaded with any other 
URI scheme. 


Parameters 


scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


register_uri_scheme_as_cors_enabled|register_uri_scheme_as_display_isolated| 
register_uri_scheme_as_empty_documentfregister_uri_scheme_as_locall 
luri_scheme_is_display_isolatedjuri_scheme_is_empty_documentjuri_scheme_is_locall 
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Method 


WebKit2Security Managerregister_uri_scheme_as_secure 
Declaration 


void 


webkit_security_manager_register_uri_scheme_as_secure ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Register scheme as a secure scheme. 


This means that mixed content warnings won’t be generated for this scheme when included by an 
HTTPS page. 


Parameters 


scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


register_uri_scheme_as_cors_enabled|register_uri_scheme_as_display_isolated| 
register_uri_scheme_as_empty_documentfregister_uri_scheme_as_locall 
luri_scheme_is_display_isolatedjuri_scheme_is_empty_documentjuri_scheme_is_locall 
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Method 


WebKit IS ecurityManageruri_scheme_is_cors_enabled 
Declaration 


gboolean 
webkit_security_manager_uri_scheme_is_cors_enabled ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Whether scheme is considered as a CORS enabled scheme. 


See also webkit_security_manager_register_uri_scheme_as_cors_enabled(). 


Parameters 
scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE if scheme is a CORS enabled scheme or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


register_uri_scheme_as_cors_enabled|register_uri_scheme_as_display_isolated| 
register_uri_scheme_as_empty_documentfregister_uri_scheme_as_locall 
luri_scheme_is_display_isolatedjuri_scheme_is_empty_documentjuri_scheme_is_locall 
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Method 


WebKit IS ecurityManageruri_scheme_is_display_isolated 
Declaration 


gboolean 
webkit_security_manager_uri_scheme_is_display_isolated ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Whether scheme is considered as a display isolated scheme. 


See also webkit_security_manager_register_uri_scheme_as_display_isolated(). 


Parameters 
scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE if scheme is a display isolated scheme or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


register_uri_scheme_as_cors_enabled|register_uri_scheme_as_display_isolated| 
register_uri_scheme_as_empty_documentfregister_uri_scheme_as_locall 
luri_scheme_is_display_isolatedjuri_scheme_is_empty_documentjuri_scheme_is_locall 


Generated by[gi-docgen]2023.3 
Method 


WebKit 28 ecurityManageruri_scheme_is_empty_document 
Declaration 


gboolean 
webkit_security_manager_uri_scheme_is_empty_document ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Whether scheme is considered as an empty document scheme. 


See also webkit_security_manager_register_uri_scheme_as_empty_document(). 


Parameters 
scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE if scheme is an empty document scheme or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


register_uri_scheme_as_cors_enabled|register_uri_scheme_as_display_isolated| 
register_uri_scheme_as_empty_documentfregister_uri_scheme_as_locall 
luri_scheme_is_display_isolatedjuri_scheme_is_empty_documentjuri_scheme_is_locall 
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Method 


WebKit2SecurityManageruri_scheme_is_local 
Declaration 


gboolean 

webkit_security_manager_uri_scheme_is_local ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Whether scheme is considered as a local scheme. 


See also webkit_security_manager_register_uri_scheme_as_local(). 


Parameters 
scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE if scheme is a local scheme or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


register_uri_scheme_as_cors_enabled|register_uri_scheme_as_display_isolated| 
register_uri_scheme_as_empty_documentfregister_uri_scheme_as_locall 


Generated by[gi-docgen]2023.3 
Method 


WebKit IS ecurityManageruri_scheme_is_no_access 
Declaration 


gboolean 
webkit_security_manager_uri_scheme_is_no_access ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Whether scheme is considered as a no-access scheme. 


See also webkit_security_manager_register_uri_scheme_as_no_access(). 


Parameters 
scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE if scheme is a no-access scheme or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


register_uri_scheme_as_cors_enabled|register_uri_scheme_as_display_isolated| 
register_uri_scheme_as_empty_documentfregister_uri_scheme_as_locall 


Generated by[gi-docgen]2023.3 
Method 


WebKit IS ecurityManageruri_scheme_is_secure 
Declaration 


gboolean 

webkit_security_manager_uri_scheme_is_secure ( 
WebKitSecurityManager* security_manager, 
const gchar* scheme 


) 


Description 


Whether scheme is considered as a secure scheme. 


See also webkit_security_manager_register_uri_scheme_as_secure(). 


Parameters 
scheme 


Type: const gchar* 


A URI scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE if scheme is a secure scheme or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Constructors 
new_with settings 


Functions 


font_size_to_pixels|font_size_to_points]get_all_features]get_development_features 
get_experimental_features 


Instance methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ignoring_image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_encrypted_mediaJset_enable_frame_flattening}|set_enable_fullscreen 
set_enable_html5_database]set_enable_htm15_local_storage]set_enable_hyperlink_auditing 


set_load_icons_ignoring_image_load_setting 


Properties 


image- -load- setting media- content- types-requiring -hardware- sup port 
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Class 


WebKit2Settings 


unstable since: 4.1 


Description 


class WebKit2.Settings : GObject.Object 
{ 

priv: WebKitSettingsPrivate* 
} 


Control the behaviour of a WebKitWebView. 


WebKitSettings can be applied to a WebKitWebView to control text charset, color, font sizes, 
printing mode, script support, loading of images and various other things on a WebKitWebView. After 
creation, aWebKitSettings object contains default settings. 


// Disable JavaScript 
WebKitSettings *settings = webkit_web_view_group_get_settings (my_view_group) ; 
webkit_settings_set_enable_javascript (settings, FALSE); 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitSettings ancestor_0 GObject ancestor_O--this 
Ancestors 
@ GObject 


Constructors 


webkit_settings_new 
Creates a new WebKit Settings instance with default values. 


unstable since: 4.1 


webkit_settings_new_with_settings 


Creates anew WebKit Settings instance with the given settings. 


unstable since: 4.1 


Functions 


webkit_settings_font_size_to_pixels 


Convert points to the equivalent value in pixels. 


since: 2.20 


webkit_settings_font_size_to_points 


Convert pixels to the equivalent value in points. 
since: 2.20 

Gets the list of all available WebKit features. 

since: 2.42 

Gets the list of available development WebKit features. 
since: 2.42 

Gets the list of available experimental WebKit features. 


since: 2.42 


Instance methods 


webkit_settings_get_allow_file_access_from_file_urls 


Get the WebKitSettings:allow-file-access-—from—file-—urls property. 
since: 2.10 
Get the WebKitSettings:allow-modal-dialogs property. 


unstable since: 4.1 


webkit_settings_get_allow_top_navigation_to_data_urls 


Get the WebKitSettings:allow-top-navigation-to-data-urls property. 


since: 2.28 


webkit_settings_get_allow_universal_access_from_file_urls 


Get the WebKitSettings:allow-universal-access—from—file-—urls property. 


since: 2.14 
webkit_settings_get_auto_load_images 
Get the WebKitSettings:auto-load-images property. 


unstable since: 4.1 


webkit_settings_get_cursive_font_family 


Gets the WebKitSettings:cursive-font—family property. 
unstable since: 4.1 

Gets the WebKitSettings:default—charset property. 
unstable since: 4.1 

Gets the WebKitSettings:default-—font—family property. 
unstable since: 4.1 

Gets the WebKitSettings:default—font—size property. 


unstable since: 4.1 


webkit_settings_get_default_monospace_font_size 


Gets the WebKitSettings:default-—monospace-font-—size property. 


unstable since: 4.1 


webkit_settings_get_disable_web_security 


Get the WebKitSettings:disable-web-security property. 


since: 2.40 


webkit_settings_get_draw_compositing_indicators 


Get the WebKitSettings:draw-compositing-indicators property. 


unstable since: 4.1 


webkit_settings_get_enable_accelerated_2d_canvas 


Get the WebKitSettings:enable-accelerated-2d-canvas property. 


deprecated: 2.32. since: 2.2 


webkit_settings_get_enable_back_forward_navigation_gestures 


Get the WebKitSettings:enable-back-forward-navigation-gestures property. 


since: 2.24 


webkit_settings_get_enable_caret_browsing 


Get the WebKitSettings:enable-caret—browsing property. 


unstable since: 4.1 


webkit_settings_get_enable_developer_extras 


Get the WebKitSettings:enable-developer-extras property. 


unstable since: 4.1 


webkit_settings_get_enable_dns_prefetching 


Get the WebKitSettings:enable-dns-prefetching property. 


unstable since: 4.1 

Get the WebKitSettings:enable-encrypted-media property. 
since: 2.20 

Frame flattening is no longer supported. This function returns FALSE. 
unstable deprecated: 2.38 since: 4.1 


webkit_settings_get_enable_fullscreen| 


Get the WebKitSettings:enable-fullscreen property. 


unstable since: 4.1 


webkit_settings_get_enable_html5_database 


Get the WebKitSettings:enable-htm15-database property. 


unstable since: 4.1 


webkit_settings_get_enable_html5_local_storage 


Get the WebKitSettings:enable-htm15-local-storage property. 


unstable since: 4.1 


webkit_settings_get_enable_hyperlink_auditing 


Get the WebKitSettings:enable-hyperlink-—auditing property. 
unstable since: 4.1 
Get the WebKitSettings:enable-java property. 


unstable deprecated: 2.38. since: 4.1 


webkit_settings_get_enable_javascript 


Get the WebKitSettings:enable-javascript property. 


unstable since: 4.1 


webkit_settings_get_enable_javascript_markup 


Get the WebKitSettings:enable-javascript-—markup property. 
since: 2.24 
Get the WebKitSettings:enable-media property. 


since: 2.26 


webkit_settings_get_enable_media_capabilities 


Get the WebKitSettings:enable-media-capabilities property. 


since: 2.22 


webkit_settings_get_enable_media_stream 


Get the WebKitSettings:enable-media-—stream property. 


since: 2.4 


webkit_settings_get_enable_mediasource 


Get the WebKitSettings:enable-mediasource property. 


since: 2.4 


webkit_settings_get_enable_mock_capture_devices 


Get the WebKitSettings:enable-mock-capture-—devices property. 


since: 2.24 


webkit_settings_get_enable_offline_web_application_cache 


Get the WebKitSettings:enable-offline-web-application-cache property. 


unstable since: 4.1 


webkit_settings_get_enable_page_cache 


Get the WebKitSettings:enable-page-cache property. 


unstable since: 4.1 
webkit_settings_get_enable_plugins 
Get the WebKitSettings:enable-plugins property. 


unstable deprecated: 2.32 since: 4.1 


webkit_settings_get_enable_private_browsing 


Get the WebKitSettings:enable-private-browsing property. 


unstable deprecated: 2.16. since: 4.1 


webkit_settings_get_enable_resizable_text_areas 


Get the WebKitSettings:enable-resizable-text-—areas property. 


unstable since: 4.1 


webkit_settings_get_enable_site_specific_quirks 


Get the WebKitSettings:enable-site-specific—quirks property. 
unstable since: 4.1 
Get the WebKitSettings:enable-smooth-scrolling property. 


unstable since: 4.1 


webkit_settings_get_enable_spatial_navigation 


Get the WebKitSettings:enable-spatial-—navigation property. 


since: 2.2 


webkit_settings_get_enable_tabs_to_links 


Get the WebKitSettings:enable-tabs-to-links property. 


unstable since: 4.1 

Get the WebKitSettings:enable-webaudio property. 
unstable since: 4.1 

Get the WebKitSettings:enable-—webgl property. 
unstable since: 4.1 

Get the WebKitSettings:enable-webrtc property. 


since: 2.38 


webkit_settings_get_enable_write_console_messages_to_stdout 


Get the WebKitSettings:enable-write-console-messages-—to-stdout property. 


since: 2.2 

The XSS auditor has been removed. This function returns FALSE. 
unstable deprecated: 2.38. since: 4.1 

Gets the WebKitSettings: fantasy-font—family property. 
unstable since: 4.1 

Gets whether a feature is enabled. 


since: 2.42 


webkit_settings_get_hardware_acceleration_policy 


Get the WebKitSettings:hardware-acceleration-—policy property. 


since: 2.16 


webkit_settings_get_javascript_can_access_clipboard 


Get the WebKitSettings: javascript-—can-access-—clipboard property. 


unstable since: 4.1 


webkit_settings_get_javascript_can_open_windows_automatically 


Get the WebKit Settings: javascript—can-open-—windows-automatically property. 


unstable since: 4.1 


webkit_settings_get_load_icons_ignoring_image_load_setting 


Setting no longer supported. This function returns FALSE. 


unstable deprecated: 2.42 since: 4.1 


webkit_settings_get_media_content_types_requiring_hardware_support| 


Gets the WebKitSettings:media-content-types-requiring-hardware-support 
property. 


since: 2.30 


webkit_settings_get_media_playback_allows_inline 


Get the WebKitSettings:media-playback-—allows-—inline property. 


unstable since: 4.1 


webkit_settings_get_media_playback_requires_user_gesture 


Get the WebKitSettings:media-playback-requires-—user-—gesture property. 


unstable since: 4.1 


webkit_settings_get_minimum_font_size 


Gets the WebKitSettings:minimum-font-—size property. 


unstable since: 4.1 


webkit_settings_get_monospace_font_family 


Gets the WebKitSettings :monospace-font-—family property. 


unstable since: 4.1 


webkit_settings_get_pictograph_font_family 


Gets the WebKitSettings:pictograph-font—family property. 
unstable since: 4.1 
Get the WebKitSettings:print-—backgrounds property. 


unstable since: 4.1 


webkit_settings_get_sans_serif_font_family 


Gets the WebKitSettings:sans-—serif—font—family property. 


unstable since: 4.1 


webkit_settings_get_serif_font_family 


Gets the WebKitSettings:serif—font—family property. 


unstable since: 4.1 

Get the WebKitSettings:user-—agent property. 
unstable since: 4.1 

Get the WebKitSettings:zoom—text-—on]y property. 


unstable since: 4.1 


webkit_settings_set_allow_file_access_from_file_urls 


Set the WebKitSettings:allow-file-access—from—file-—urls property. 


since: 2.10 


webkit_settings_set_allow_modal_dialogs 


Set the WebKitSettings:allow-—modal-—dialogs property. 


unstable since: 4.1 


webkit_settings_set_allow_top_navigation_to_data_urls 


Set the WebKitSettings:allow-top-navigation-to-data-urls property. 


since: 2.28 


webkit_settings_set_allow_universal_access_from_file_urls 


Set the WebKitSettings:allow-universal-—access—from—file-—urls property. 
since: 2.14 
Set the WebKitSettings:auto-load-images property. 


unstable since: 4.1 


webkit_settings_set_cursive_font_family 


Set the WebKitSettings:cursive-font-—family property. 


unstable since: 4.1 

Set the WebKitSettings:default—charset property. 
unstable since: 4.1 

Set the WebKitSettings:default—font-—family property. 
unstable since: 4.1 

Set the WebKitSettings:default—font-—size property. 


unstable since: 4.1 


webkit_settings_set_default_monospace_font_size 


Set the WebKitSettings:default-—monospace-font-—size property. 


unstable since: 4.1 


webkit_settings_set_disable_web_security 


Set the WebKitSettings:disable-web-security property. 


since: 2.40 


webkit_settings_set_draw_compositing_indicators 


Set the WebKitSettings:draw-compositing-indicators property. 


unstable since: 4.1 


webkit_settings_set_enable_accelerated_2d_canvas 


Set the WebKitSettings:enable-accelerated-—2d-canvas property. 


deprecated: 2.32. since: 2.2 


webkit_settings_set_enable_back_forward_navigation_gestures 


Set the WebKitSettings:enable-back-forward-navigation-gestures property. 


since: 2.24 


webkit_settings_set_enable_caret_browsing 


Set the WebKitSettings:enable-caret—browsing property. 
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webkit_settings_set_enable_developer_extras 


Set the WebKitSettings:enable-developer-—extras property. 
unstable since: 4.1 


webkit_settings_set_enable_dns_prefetching 


Set the WebKitSettings:enable-dns-prefetching property. 
unstable since: 4.1 

Set the WebKitSettings:enable-encrypted-media property. 
since: 2.20 

webkit_settings_set_enable_frame_flattening 

Frame flattening is no longer supported. This function does nothing. 
unstable deprecated: 2.38 since: 4.1 


webkit_settings_set_enable_fullscreen 


Set the WebKitSettings:enable-fullscreen property. 
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webkit_settings_set_enable_html5_database 


Set the WebKitSettings:enable-htm15-database property. 
unstable since: 4.1 
webkit_settings_set_enable_html5_local_storage 


Set the WebKitSettings:enable-htm15-local-storage property. 


unstable since: 4.1 


webkit_settings_set_enable_hyperlink_auditing 


Set the WebKitSettings:enable-hyperlink-auditing property. 
unstable since: 4.1 

webkit_settings_set_enable_java 

Set the WebKitSettings:enable-java property. 

unstable deprecated: 2.38. since: 4.1 
[webkit_settings_set_enable_javascript] 

Set the WebKitSettings:enable-javascript property. 

unstable since: 4.1 

webkit_settings_set_enable_javascript_markup 

Set the WebKitSettings:enable-javascript—markup property. 
since: 2.24 

[webkit_settings_set_enable_media] 

Set the WebKitSettings:enable-media property. 


since: 2.26 


webkit_settings_set_enable_media_capabilities 


Set the WebKitSettings:enable-media-capabilities property. 


since: 2.22 


webkit_settings_set_enable_media_stream 


Set the WebKitSettings:enable-media-—stream property. 


since: 2.4 


webkit_settings_set_enable_mediasource 


Set the WebKitSettings:enable-mediasource property. 


since: 2.4 


webkit_settings_set_enable_mock_capture_devices 


Set the WebKitSettings:enable-mock-capture-devices property. 


since: 2.4 


webkit_settings_set_enable_offline_web_application_cache 


Set the WebKitSettings:enable-offline-web-application-cache property. 


unstable since: 4.1 


webkit_settings_set_enable_page_cache 


Set the WebKitSettings:enable-page-cache property. 


unstable since: 4.1 
webkit_settings_set_enable_plugins 
Set the WebKitSettings:enable-plugins property. 


unstable deprecated: 2.32 since: 4.1 


webkit_settings_set_enable_private_browsing 


Set the WebKitSettings:enable-private-browsing property. 


unstable deprecated: 2.16. since: 4.1 


webkit_settings_set_enable_resizable_text_areas 


Set the WebKitSettings:enable-resizable-text-—areas property. 


unstable since: 4.1 


webkit_settings_set_enable_site_specific_quirks 


Set the WebKitSettings:enable-site-specific—quirks property. 


unstable since: 4.1 


webkit_settings_set_enable_smooth_scrolling 


Set the WebKitSettings:enable-smooth-scrolling property. 


unstable since: 4.1 


webkit_settings_set_enable_spatial_navigation 


Set the WebKitSettings:enable-spatial-—navigation property. 


since: 2.2 


webkit_settings_set_enable_tabs_to_links 


Set the WebKitSettings:enable-tabs-to-links property. 
unstable since: 4.1 

Set the WebKitSettings:enable-webaudio property. 
unstable since: 4.1 

Set the WebKitSettings:enable-webgl property. 

unstable since: 4.1 

Set the WebKitSettings:enable-—webrtc property. 


since: 2.38 


webkit_settings_set_enable_write_console_messages_to_stdout 


Set the WebKitSettings:enable-write-console-messages-—to-stdout property. 
since: 2.2 

The XSS auditor has been removed. This function does nothing. 

unstable deprecated: 2.38. since: 4.1 


webkit_settings_set_fantasy_font_family 


Set the WebKitSettings:fantasy—font—family property. 


unstable since: 4.1 


webkit_settings_set_feature_enabled 


Enables or disables a feature. 


since: 2.42 


webkit_settings_set_hardware_acceleration_policy 


Set the WebKitSettings:hardware-acceleration-policy property. 


since: 2.16 


webkit_settings_set_javascript_can_access_clipboard 


Set the WebKitSettings: javascript-—can-access-—clipboard property. 


unstable since: 4.1 


webkit_settings_set_javascript_can_open_windows_automatically 


Set the WebKitSettings: javascript—can-open-windows-—automatically property. 


unstable since: 4.1 


webkit_settings_set_load_icons_ignoring_image_load_setting 


Setting no longer supported. This function does nothing. 


unstable deprecated: 2.42 since: 4.1 


webkit_settings_set_media_content_types_requiring_hardware_support 


Set the WebKitSettings:media-content-types-—requiring-hardware-support 
property. 


since: 2.30 


webkit_settings_set_media_playback_allows_inline 


Set the WebKitSettings:media-playback-allows-—inline property. 


unstable since: 4.1 


webkit_settings_set_media_playback_requires_user_gesture 


Set the WebKitSettings:media-playback-requires-user-gesture property. 


unstable since: 4.1 


webkit_settings_set_minimum_font_size 


Set the WebKitSettings:minimum-—font-—size property. 
unstable since: 4.1 

Set the WebKitSettings:monospace-font-—family property. 
unstable since: 4.1 

Set the WebKitSettings:pictograph-font—family property. 
unstable since: 4.1 

Set the WebKitSettings:print—backgrounds property. 


unstable since: 4.1 


webkit_settings_set_sans_serif_font_family 


Set the WebKitSettings:sans-—serif—font—family property. 


unstable since: 4.1 


webkit_settings_set_serif_font_family 


Set the WebKitSettings:serif—font-—family property. 
unstable since: 4.1 
Set the WebKitSettings:user-—agent property. 


unstable since: 4.1 


webkit_settings_set_user_agent_with_application_details 


Set the WebKitSettings:user-—agent property by appending the application details. 
unstable since: 4.1 

Set the WebKitSettings: zoom—text—on1]1y property. 

unstable since: 4.1 

Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.Settings:allow-file-access-from-file-urls 


Whether file access is allowed from file URLs. By default, when something is loaded in a 
WebKitWebView using a file URI, cross origin requests to other file resources are not allowed. This 
setting allows you to change that behaviour, so that it would be possible to do a XMLHttpRequest of a 
local file, for example. 


since: 2.10 


WebKit2.Settings:allow-modal-dialogs 


Determine whether it’s allowed to create and run modal dialogs from a WebKitWebView through 
JavaScript with window.showModalDialog. If it’s set to FALSE, the associated WebKitWebView won’t 
be able to create new modal dialogs, so not even the WebKitWebView: : create signal will 

be emitted. 


unstable since: 4.1 


WebKit2.Settings:allow-top-navigation-to-data-urls 


Whether or not the top frame is allowed to navigate to data URLs. It is disabled by default due to the risk 
it poses when loading untrusted URLs, with data URLs being used in scamming and phishing attacks. In 
contrast, a scenario where it could be enabled could be an app that embeds a WebView and you have 
control of the pages being show instead of a generic browser. 


since: 2.28 


WebKit2.Settings:allow-universal-access-from-file-urls 


Whether or not JavaScript running in the context of a file scheme URL should be allowed to access 
content from any origin. By default, when something is loaded in a WebKit WebView using a file scheme 
URL, access to the local file system and arbitrary local storage is not allowed. This setting allows you to 
change that behaviour, so that it would be possible to use local storage, for example. 


since: 2.14 


WebKit2.Settings:auto-load-images 


Determines whether images should be automatically loaded or not. On devices where network bandwidth 
is of concern, it might be useful to turn this property off. 


unstable since: 4.1 


WebKit2.Settings:cursive-font-family 


The font family used as the default for content using a cursive font. 

unstable since: 4.1 

The default text charset used when interpreting content with an unspecified charset. 
unstable since: 4.1 

The font family to use as the default for content that does not specify a font. 

unstable since: 4.1 

The default font size in pixels to use for content displayed if no font size is specified. 


unstable since: 4.1 


WebKit2.Settings:default-monospace-font-size 


The default font size in pixels to use for content displayed in monospace font if no font size is specified. 


unstable since: 4.1 


WebKit2.Settings:disable-web-security 


Enable or disable support for Web Security on pages. 


since: 2.40 


WebKit2.Settings:draw-compositing-indicators 


Whether to draw compositing borders and repaint counters on layers drawn with accelerated compositing. 
This is useful for debugging issues related to web content that is composited with the GPU. 


unstable since: 4.1 


WebKit2.Settings:enable-accelerated-2d-canvas 


Enable or disable accelerated 2D canvas. Accelerated 2D canvas is only available if WebKit was compiled 
with a version of Cairo including the unstable CairoGL API. When accelerated 2D canvas is enabled, 
WebKit may render some 2D canvas content using hardware accelerated drawing operations. 


deprecated: 2.32. since: 2.2 


WebKit2.Settings:enable-back-forward-navigation-gestures 


Enable or disable horizontal swipe gesture for back-forward navigation. 

since: 2.24 

Whether to enable accessibility enhanced keyboard navigation. 

unstable since: 4.1 

Determines whether or not developer tools, such as the Web Inspector, are enabled. 
unstable since: 4.1 


WebKit2.Settings:enable-dns-prefetching 


Determines whether or not to prefetch domain names. DNS prefetching attempts to resolve domain names 
before a user tries to follow a link. 


unstable since: 4.1 


WebKit2.Settings:enable-encrypted-media 


Enable or disable support for Encrypted Media API on pages. EncryptedMedia is an experimental 
JavaScript API for playing encrypted media in HTML. This property will only work as intended if the 
EncryptedMedia feature is enabled at build time with the ENABLE_ENCRYPTED_MEDIA flag. 


since: 2.20 

[WebKit2.Settings:enable-frame-flattening| 

Frame flattening is no longer supported. This property does nothing. 
unstable deprecated: 2.38 since: 4.1 


WebKit2.Settings:enable-fullscreen 


Whether to enable the Javascript Fullscreen API. The API allows any HTML element to request fullscreen 
display. See also the current draft of the spec: http://www.w3.org/TR/fullscreen/ 


unstable since: 4.1 
Whether to enable HTMLS client-side SQL database support (IndexedDB). 
unstable since: 4.1 


WebKit2.Settings:enable-html5-local-storage 


Whether to enable HTMLS5 local storage support. Local storage provides simple synchronous 
storage access. 


unstable since: 4.1 
[WebKit2.Settings:enable-hyperlink-auditing| 
Determines whether or not hyperlink auditing is enabled. 
unstable since: 4.1 

[WebKit2.Settings:enable-javal 

Determines whether or not Java is enabled on the page. 


unstable deprecated: 2.38 since: 4.1 


WebKit2.Settings:enable-javascript 


Determines whether or not JavaScript executes within a page. 


unstable since: 4.1 


WebKit2.Settings:enable-javascript-markup 


Determines whether or not JavaScript markup is allowed in document. When this setting is disabled, all 
JavaScript-related elements and attributes are removed from the document during parsing. Note that 
executing JavaScript is still allowed if WebKitSettings:enable-javascript is TRUE. 


since: 2.24 


WebKit2.Settings:enable-media 


Enable or disable support for media playback on pages. This setting is enabled by default. Disabling it 
means <audio>, <track> and <video> elements will have playback support disabled. 


since: 2.26 


WebKit2.Settings:enable-media-capabilities 


Enable or disable support for MediaCapabilities on pages. This specification intends to provide APIs to 
allow websites to make an optimal decision when picking media content for the user. The APIs will 
expose information about the decoding and encoding capabilities for a given format but also output 
capabilities to find the best match based on the deviceas display. 


since: 2.22 


WebKit2.Settings:enable-media-stream 


Enable or disable support for MediaStream on pages. MediaStream is an experimental proposal for 
allowing web pages to access audio and video devices for capture. 


since: 2.4 


WebKit2.Settings:enable-mediasource 


Enable or disable support for MediaSource on pages. MediaSource extends HTMLMediaElement to allow 
JavaScript to generate media streams for playback. 


since: 2.4 


WebKit2.Settings:enable-mock-capture-devices 


Enable or disable the Mock Capture Devices. Those are fake Microphone and Camera devices to be used 
as MediaStream sources. 


since: 2.24 


WebKit2.Settings:enable-offline-web-application-cache 


Whether to enable HTML5S offline web application cache support. Offline web application cache allows 
web applications to run even when the user is not connected to the network. 


unstable since: 4.1 


WebKit2.Settings:enable-page-cache 


Enable or disable the page cache. Disabling the page cache is generally only useful for special 
circumstances like low-memory scenarios or special purpose applications like static HTML viewers. This 
setting only controls the Page Cache, this cache is different than the disk-based or memory-based 
traditional resource caches, its point is to make going back and forth between pages much faster. For 
details about the different types of caches and their purposes 

see: http://webkit.org/blog/427/webkit-page-cache-i-the-basics/ 


unstable since: 4.1 
Determines whether or not plugins on the page are enabled. 
unstable deprecated: 2.32 since: 4.1 


WebKit2.Settings:enable-private-browsing 


Determines whether or not private browsing is enabled. Private browsing will disable history, cache and 
form auto-fill for any pages visited. 


unstable deprecated: 2.16. since: 4.1 
WebKit2.Settings:enable-resizable-text-areas 
Determines whether or not text areas can be resized. 


unstable since: 4.1 


WebKit2.Settings:enable-site-specific-quirks 


Whether to turn on site-specific quirks. Turning this on will tell WebKit to use some site-specific 
workarounds for better web compatibility. For example, older versions of MediaWiki will incorrectly send 
to WebKit a CSS file with KHTML workarounds. By turning on site-specific quirks, WebKit will 
special-case this and other cases to make some specific sites work. 


unstable since: 4.1 


WebKit2.Settings:enable-smooth-scrolling 


Enable or disable smooth scrolling. 


unstable since: 4.1 


WebKit2.Settings:enable-spatial-navigation 


Whether to enable Spatial Navigation. This feature consists in the ability to navigate between focusable 
elements in a Web page, such as hyperlinks and form controls, by using Left, Right, Up and Down arrow 
keys. For example, if an user presses the Right key, heuristics determine whether there is an element they 
might be trying to reach towards the right, and if there are multiple elements, which element they 
probably wants. 


since: 2.4 


WebKit2.Settings:enable-tabs-to-links 


Determines whether the tab key cycles through the elements on the page. When this setting is enabled, 
users will be able to focus the next element in the page by pressing the tab key. If the selected element is 
editable, then pressing tab key will insert the tab character. 


unstable since: 4.1 


WebKit2.Settings:enable-webaudio 


Enable or disable support for WebAudio on pages. WebAudio is an API for processing and synthesizing 
audio in web applications. 


unstable since: 4.1 
WebKit2.Settings:enable-webgl 


Enable or disable support for WebGL on pages. WebGL enables web content to use an API based on 
OpenGL ES 2.0. 


unstable since: 4.1 


WebKit2.Settings:enable-webrtc 


Enable WebRTC support for loaded pages. 


since: 2.38 


WebKit2.Settings:enable-write-console-messages-to-stdout 


Enable or disable writing console messages to stdout. These are messages sent to the console with 
console.log and related methods. 


since: 2.2 


WebKit2.Settings:enable-xss-auditor 


Whether to enable the XSS auditor. This feature filters some kinds of reflective XSS attacks on vulnerable 
web sites. 


unstable deprecated: 2.38 since: 4.1 
The font family used as the default for content using a fantasy font. 
unstable since: 4.1 


WebKit2.Settings:hardware-acceleration-policy 


The WebKitHardwareAccelerationPolicy to decide how to enable and disable hardware 
acceleration. Disabling hardware acceleration might cause some websites to not render correctly or 
consume more CPU. 


since: 2.16 


WebKit2.Settings:javascript-can-access-clipboard 


Whether JavaScript can access the clipboard. The default value is FALSE. If set to TRUE, 
document.execCommand() allows cut, copy and paste commands. 


unstable since: 4.1 


WebKit2.Settings:javascript-can-open-windows-automatically 


Whether JavaScript can open popup windows automatically without user intervention. 


unstable since: 4.1 


WebKit2.Settings:load-icons-ignoring-image-load-setting 


Unsupported setting. This property does nothing. 


unstable deprecated: 2.42 since: 4.1 


WebKit2.Settings:media-content-types-requiring-hardware-support 


List of media content types requiring hardware support, split by semicolons (:). For example: 
“video/webm; codecs=’’vp “:video/mp4; codecs=”avc*:video/&ast; codecs="av1*’”’. 


since: 2.30 


WebKit2.Settings:media-playback-allows-inline 


Whether media playback is full-screen only or inline playback is allowed. This is TRUE by default, so 
media playback can be inline. Setting it to FALSE allows specifying that media playback should be 
always fullscreen. 


unstable since: 4.1 


WebKit2.Settings:media-playback-requires-user-gesture 


Whether a user gesture (such as clicking the play button) would be required to start media playback or 
load media. This is off by default, so media playback could start automatically. Setting it on requires a 
gesture by the user to start playback, or to load the media. 


unstable since: 4.1 


WebKit2.Settings:minimum-font-size 


The minimum font size in pixels used to display text. This setting controls the absolute smallest size. 
Values other than 0 can potentially break page layouts. 


unstable since: 4.1 

[WebKit2.Settings:monospace-font-family| 

The font family used as the default for content using a monospace font. 
unstable since: 4.1 

[WebKit2.Settings:pictograph-font-family| 

The font family used as the default for content using a pictograph font. 
unstable since: 4.1 

[WebKit2.Settings:print-backgrounds| 

Whether background images should be drawn during printing. 
unstable since: 4.1 

The font family used as the default for content using a sans-serif font. 


unstable since: 4.1 


WebKit2.Settings:serif-font-family 


The font family used as the default for content using a serif font. 


unstable since: 4.1 


WebKit2.Settings:user-agent 


The user-agent string used by WebKit. Unusual user-agent strings may cause web content to render 
incorrectly or fail to run, as many web pages are written to parse the user-agent strings of only the most 
popular browsers. Therefore, it’s typically better to not completely override the standard user-agent, but to 
use webkit_settings_set_user_agent_with_application_details () instead. 


unstable since: 4.1 


WebKit2.Settings:zoom-text-only 


Whether WebKitWebView: zoom-level affects only the text of the page or all the contents. Other 
contents containing text like form controls will be also affected by zoom factor when this property 
is enabled. 


unstable since: 4.1 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2SettingsClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 
void 


i 


No description available. 
Class members 


parent_class: 
No description available. 

_webkit_reserved0: void 
No description available. 

_webkit_reservedl: void 
No description available. 

_webkit_reserved2: void 
No description available. 

_webkit_reserved3: void 
No description available. 
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Constructor 


WebKit2Settingsnew 
Declaration 


WebKitSettings* 
webkit_settings_new ( 
void 


) 


Description 


Creates anew WebKit Settings instance with default values. 


It must be manually attached to a WebKitWebView. See also webkit_settings_new_with_settings(). 


Return value 


Type: |WebKitSettings 


A new WebKitSettings instance. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Constructors 


new 
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Constructor 


WebKit2Settingsnew_with_settings 
Declaration 


WebKitSettings* 
webkit_settings_new_with_settings ( 
const gchar* first_setting_name, 


Description 


Creates anew WebKit Settings instance with the given settings. 
It must be manually attached to a WebKitWebView. 
This method is not directly available to language bindings. 
Parameters 
first_setting_name 

Type: const gchar* 


Name of first setting to set. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


Type: 


Value of first setting, followed by more settings, NULL-terminated. 


Return value 


Type:|WebKitSettings 


A new WebKitSettings instance. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Functions 


font_size_to_pixels|font_size_to_points]get_all_features]get_development_features 
get_experimental_features 
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Function 


WebKit2Settingsfont_size_to_pixels 


since: 2.20 


Declaration 


guint32 

webkit_settings_font_size_to_pixels ( 
guint32 points 

) 


Description 


Convert points to the equivalent value in pixels. 


Convert points to the equivalent value in pixels, based on the current screen DPI. Applications can use 
this function to convert font size values in points to font size values in pixels when setting the font size 
properties of WebKitSettings. 


Available since: 2.20 


Parameters 
points 
Type: guint32 


The font size in points to convert to pixels. 


Return value 
Type: guint32 


The equivalent font size in pixels. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Functions 


font_size_to_pixels|font_size_to_points]get_all_features]get_development_features 
get_experimental_features 
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Function 


WebKit2Settingsfont_size_to_points 


since: 2.20 


Declaration 


guint32 

webkit_settings_font_size_to_points ( 
guint32 pixels 

) 


Description 


Convert pixels to the equivalent value in points. 


Convert pixels to the equivalent value in points, based on the current screen DPI. Applications can use 
this function to convert font size values in pixels to font size values in points when getting the font size 
properties of WebKitSettings. 


Available since: 2.20 


Parameters 
pixels 
Type: guint32 


The font size in pixels to convert to points. 


Return value 
Type: guint32 


The equivalent font size in points. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Functions 


font_size_to_pixels|font_size_to_points]get_all_features]get_development_features 
get_experimental_features 
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Function 


WebKit2Settingsget_all_features 


since: 2.42 


Declaration 


WebKitFeatureList* 
webkit_settings_get_all_features ( 
void 


) 


Description 


Gets the list of all available WebKit features. 


Features can be toggled withjwebkit_settings_set_feature_enabled ()| and their current 
state determined with|webkit_settings_get_feature_enabled() 


Note that most applications should usejwebkit_settings_get_development_features () 


webkit_settings_get_experimental_features () |instead. 


Available since: 2.42 


Return value 


Type: |WebKitFeatureList 


List of all features. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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Library Version: 2.42.4 
Type 


Functions 
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Generated by[gi-docgen]2023.3 


Function 


WebKit2Settingsget_development_features 


since: 2.42 


Declaration 


WebKitFeatureList* 
webkit_settings_get_development_features ( 
void 


) 


Description 


Gets the list of available development WebKit features. 


The returned features are a subset of those returned byjwebkit_settings_get_all_ features () 


and includes those which web and WebKit developers might find useful, but in general should not be 


exposed to end users; seeJWebKitFeatureStatus|for more details. 


Available since: 2.42 


Return value 


Type: |WebKitFeatureList 


List of development features. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Functions 


font_size_to_pixels|font_size_to_points]get_all_features]get_development_features 
get_experimental_features 


Generated by[gi-docgen|2023.3 


Function 


WebKit2Settingsget_experimental_features 


since: 2.42 


Declaration 


WebKitFeatureList* 
webkit_settings_get_experimental_features ( 
void 


) 


Description 


Gets the list of available experimental WebKit features. 


The returned features are a subset of those returned byjwebkit_settings_get_all_ features () 


and includes those which certain applications may want to expose to end users; see 


WebKitFeatureStatus|for more details. 
Available since: 2.42 


Return value 


Type: |WebKitFeatureList 


List of experimental features. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 
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API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor]set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


set_media_content_types_requiring_hardware_support|set_media_playback_allows_inline| 
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Method 


WebKit2Settingspet_allow_file_access_from_file_urls 


since: 2.10 


Declaration 


gboolean 

webkit_settings_get_allow_file_access_from_file_urls ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:allow-file-access—from—file-—urls property. 


Available since: 2.10 


Gets property |WebKit2.Settings:allow-file-access—from—file-urls 


Return value 
Type: gboolean 


TRUE If file access from file URLs is allowed or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_allow_modal_dialogs 


Declaration 


gboolean 

webkit_settings_get_allow_modal_dialogs ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:allow-modal-dialogs property. 


Gets property |WebKit2.Settings:allow-modal—dialogs 


Return value 
Type: gboolean 


TRUE if it’s allowed to create and run modal dialogs or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor]set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


set_media_content_types_requiring_hardware_support|set_media_playback_allows_inline| 
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Method 


WebKit2Settingsget_allow_top_navigation_to_data_urls 


since: 2.28 


Declaration 


gboolean 

webkit_settings_get_allow_top_navigation_to_data_urls ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:allow-top-navigation-to-data-urls property. 


Available since: 2.28 
Gets property |WebKit2.Settings:allow-top-navigation-to-data-urls 
Return value 


Type: gboolean 


TRUE If navigation to data URLs from the top frame is allowed or FALSE\ otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
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Method 


WebKit2Settingsget_allow_universal_access_from_file_urls 


since: 2.14 


Declaration 


gboolean 

webkit_settings_get_allow_universal_access_from_file_urls ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:allow-universal-access—from—file-—urls property. 


Available since: 2.14 


Gets property |WebKit2.Settings:allow-universal-access—from-file-urls 


Return value 
Type: gboolean 


TRUE If universal access from file URLs is allowed or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_auto_load_images 


Declaration 


gboolean 

webkit_settings_get_auto_load_images ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:auto-load-images property. 


Gets property |WebKit2.Settings:auto-load-images 


Return value 
Type: gboolean 


TRUE If auto loading of images is enabled or FALSE otherwise. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_cursive_font_family 


Declaration 


const gchar* 

webkit_settings_get_cursive_font_family ( 
WebKitSettings* settings 

) 


Description 


Gets the WebKitSettings:cursive-font—family property. 


Gets property |WebKit2.Settings:cursive-font-—family 


Return value 
Type: const gchar* 
The default font family used to display content marked with cursive font. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_default_charset 


Declaration 


const gchar* 

webkit_settings_get_default_charset ( 
WebKitSettings* settings 

) 


Description 


Gets the WebKitSettings:default—charset property. 


Gets property |WebKit2.Settings:default—charset 


Return value 
Type: const gchar* 
Default charset. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 
set_media_content_types_requiring_hardware_support 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_default_font_family 


Declaration 


const gchar* 

webkit_settings_get_default_font_family ( 
WebKitSettings* settings 

) 


Description 


Gets the WebKitSettings:default-—font—family property. 


Gets property |WebKit2.Settings:default—font-—family 


Return value 
Type: const gchar* 
The default font family used to display content that does not specify a font. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingspet_default_font_size 


Declaration 


guint32 

webkit_settings_get_default_font_size ( 
WebKitSettings* settings 

) 


Description 


Gets the WebKitSettings:default—font—size property. 


Gets property |WebKit2.Settings:default—font-size 


Return value 
Type: guint32 


The default font size, in pixels. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_default_monospace_font_size 


Declaration 


guint32 

webkit_settings_get_default_monospace_font_size ( 
WebKitSettings* settings 

) 


Description 


Gets the WebKitSettings:default—monospace-font-—size property. 


Gets property |WebKit2.Settings:default—monospace-font-size 


Return value 
Type: guint32 


Default monospace font size, in pixels. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_disable_web_security 


since: 2.40 


Declaration 


gboolean 

webkit_settings_get_disable_web_security ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:disable-web-security property. 


Available since: 2.40 
Gets property |WebKit2.Settings:disable—-web-security 
Return value 


Type: gboolean 


TRUE If web security support is disabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_draw_compositing_indicators 


Declaration 


gboolean 

webkit_settings_get_draw_compositing_indicators ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:draw-compositing-indicators property. 


Gets property |WebKit2.Settings:draw-compositing—-indicators 


Return value 
Type: gboolean 


TRUE If compositing borders are drawn or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_enable_accelerated_2d_canvas 


deprecated: 2.32. since: 2.2 


Declaration 


gboolean 

webkit_settings_get_enable_accelerated_2d_canvas ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-accelerated-2d-canvas property. 


Available since: 2.2 
Deprecated since: 2.32. 


Please do not use it in newly written code. 


Gets property |WebKit2.Settings:enable-accelerated-2d-canvas 


Return value 
Type: gboolean 


TRUE if accelerated 2D canvas is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


set_media_content_types_requiring_hardware_support|set_media_playback_allows_inline| 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_enable_back_forward_navigation_gestures 


since: 2.24 


Declaration 


gboolean 

webkit_settings_get_enable_back_forward_navigation_gestures ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-back-forward-navigation-gestures property. 


Available since: 2.24 


Gets property |WebKit2.Settings:enable—-back-forward-navigation-gestures 


Return value 
Type: gboolean 


TRUE if horizontal swipe gesture will trigger back-forward navigaiton or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_caret_browsing 


Declaration 


gboolean 

webkit_settings_get_enable_caret_browsing ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-caret—browsing property. 


Gets property |WebKit2.Settings:enable-caret—browsing 


Return value 
Type: gboolean 


TRUE If caret browsing is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_developer_extras 


Declaration 


gboolean 

webkit_settings_get_enable_developer_extras ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-developer-extras property. 


Gets property |WebKit2.Settings:enable-developer—extras 


Return value 
Type: gboolean 


TRUE If developer extras is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_dns_prefetching 


Declaration 


gboolean 

webkit_settings_get_enable_dns_prefetching ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-dns-prefetching property. 


Gets property |WebKit2.Settings:enable—dns-prefetching 


Return value 
Type: gboolean 


TRUE If DNS prefetching is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_enable_encrypted_media 


since: 2.20 


Declaration 


gboolean 

webkit_settings_get_enable_encrypted_media ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-encrypted-media property. 


Available since: 2.20 
Gets property |WebKit2.Settings:enable-encrypted-media 
Return value 


Type: gboolean 


TRUE if EncryptedMedia support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_enable_frame_flattening 


deprecated: 2.38 


Declaration 


gboolean 

webkit_settings_get_enable_frame_flattening ( 
WebKitSettings* settings 

) 


Description 


Frame flattening is no longer supported. This function returns FALSE. 
Deprecated since: 2.38 


Please do not use it in newly written code. 


Gets property |WebKit2.Settings:enable-frame-flattening 


Return value 
Type: gboolean 


FALSE. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_fullscreen 


Declaration 


gboolean 

webkit_settings_get_enable_fullscreen ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-fullscreen property. 


Gets property |WebKit2.Settings:enable-fullscreen 


Return value 
Type: gboolean 


TRUE If fullscreen support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_html5_database 


Declaration 


gboolean 

webkit_settings_get_enable_htm1l5_database ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-htm15-database property. 


Gets property |WebKit2.Settings:enable-html15-database 


Return value 
Type: gboolean 


TRUE if IndexedDB support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 
set_media_content_types_requiring_hardware_support 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_enable_html5_local_storage 


Declaration 


gboolean 

webkit_settings_get_enable_html15_local_storage ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-htm15-local-storage property. 


Gets property |WebKit2.Settings:enable-htm15—-local-storage 


Return value 
Type: gboolean 


TRUE If HTMLS local storage support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 
set_media_content_types_requiring_hardware_support 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_hyperlink_auditing 


Declaration 


gboolean 

webkit_settings_get_enable_hyperlink_auditing ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-hyperlink-auditing property. 


Gets property |WebKit2.Settings:enable-hyperlink-auditing 


Return value 
Type: gboolean 


TRUE If hyper link auditing is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingspet_enable_java 


deprecated: 2.38. 


Declaration 


gboolean 

webkit_settings_get_enable_java ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-java property. 
Deprecated since: 2.38. 


This function always returns FALSE. 


Gets property |WebKit2.Settings:enable—-java 


Return value 
Type: gboolean 


FALSE always. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_enable_javascript 


Declaration 


gboolean 

webkit_settings_get_enable_javascript ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-javascript property. 


Gets property |WebKit2.Settings:enable—-javascript 


Return value 
Type: gboolean 


TRUE If JavaScript is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_enable_javascript_markup 


since: 2.24 


Declaration 


gboolean 

webkit_settings_get_enable_javascript_markup ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-javascript-—markup property. 


Available since: 2.24 


Gets property |WebKit2.Settings:enable-javascript-—markup 
Return value 


Type: gboolean 


TRUE if JavaScript markup is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_enable_media 


since: 2.26 


Declaration 


gboolean 

webkit_settings_get_enable_media ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-media property. 


Available since: 2.26 
Gets property |WebKit2.Settings:enable-media 
Return value 


Type: gboolean 


TRUE if media support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_enable_media_capabilities 


since: 2.22 


Declaration 


gboolean 

webkit_settings_get_enable_media_capabilities ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-media-capabilities property. 


Available since: 2.22 


Gets property |WebKit2.Settings:enable-media-capabilities 


Return value 
Type: gboolean 


TRUE if MediaCapabilities support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_enable_media_stream 


since: 2.4 


Declaration 


gboolean 

webkit_settings_get_enable_media_stream ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-media-—stream property. 


Available since: 2.4 


Gets property |WebKit2.Settings:enable-media-stream 


Return value 
Type: gboolean 


TRUE If mediastream support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_enable_mediasource 


since: 2.4 


Declaration 


gboolean 

webkit_settings_get_enable_mediasource ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-mediasource property. 


Available since: 2.4 


Gets property |WebKit2.Settings:enable-mediasource 


Return value 
Type: gboolean 


TRUE If MediaSource support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_enable_mock_capture_devices 


since: 2.24 


Declaration 


gboolean 

webkit_settings_get_enable_mock_capture_devices ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-mock-capture-devices property. 


Available since: 2.24 


Gets property |WebKit2.Settings:enable-mock-capture-devices 


Return value 
Type: gboolean 


TRUE If mock capture devices is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


set_media_content_types_requiring_hardware_support|set_media_playback_allows_inline| 


Generated by[gi-docgen|2023.3 
Method 


WebKit2Settingsget_enable_offline_web_application_cache 
Declaration 


gboolean 

webkit_settings_get_enable_offline_web_application_cache ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-offline-web-application-cache property. 


Gets property |WebKit2.Settings:enable-offline—web-application-—cache 


Return value 
Type: gboolean 


TRUE If HTMLS offline web application cache support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_page_cache 


Declaration 


gboolean 

webkit_settings_get_enable_page_cache ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-page-cache property. 


Gets property |WebKit2.Settings:enable-page-cache 


Return value 
Type: gboolean 


TRUE if page cache enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_enable_plugins 


deprecated: 2.32 


Declaration 


gboolean 

webkit_settings_get_enable_plugins ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-plugins property. 
Deprecated since: 2.32 


Please do not use it in newly written code. 


Gets property |WebKit2.Settings:enable-plugins 


Return value 
Type: gboolean 


TRUE If plugins are enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_enable_private_browsing 


deprecated: 2.16. 


Declaration 


gboolean 

webkit_settings_get_enable_private_browsing ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-private-browsing property. 


Deprecated since: 2.16. 


Use WebKitWebView: is—ephemeral or WebKitWebContext:is—ephemeral instead. 


Gets property |WebKit2.Settings:enable-private-browsing 


Return value 
Type: gboolean 


TRUE If private browsing is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_resizable_text_areas 


Declaration 


gboolean 

webkit_settings_get_enable_resizable_text_areas ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-resizable-text-—areas property. 


Gets property |WebKit2.Settings:enable-resizable-text—areas 


Return value 
Type: gboolean 


TRUE If text areas can be resized or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_site_specific_quirks 


Declaration 


gboolean 

webkit_settings_get_enable_site_specific_quirks ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-site-specific—quirks property. 


Gets property |WebKit2.Settings:enable-site-specific-—quirks 


Return value 
Type: gboolean 


TRUE if site specific quirks are enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_smooth_scrolling 


Declaration 


gboolean 

webkit_settings_get_enable_smooth_scrolling ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-smooth-scrolling property. 


Gets property |WebKit2.Settings:enable-smooth-scrolling 


Return value 
Type: gboolean 


TRUE if smooth scrolling is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_enable_spatial_navigation 


since: 2.2 


Declaration 


gboolean 

webkit_settings_get_enable_spatial_navigation ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-spatial-—navigation property. 


Available since: 2.2 


Gets property |WebKit2.Settings:enable-spatial-navigation 


Return value 
Type: gboolean 


TRUE If HTMLS spatial navigation support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_tabs_to_links 


Declaration 


gboolean 

webkit_settings_get_enable_tabs_to_links ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-tabs-to-links property. 


Gets property |WebKit2.Settings:enable-tabs-to-links 


Return value 
Type: gboolean 


TRUE If tabs to link is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_webaudio 


Declaration 


gboolean 

webkit_settings_get_enable_webaudio ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-webaudio property. 


Gets property |WebKit2.Settings:enable—-webaudio 


Return value 
Type: gboolean 


TRUE If webaudio support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_enable_webel 


Declaration 


gboolean 

webkit_settings_get_enable_webgl ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-—webg]l property. 


Gets property |WebKit2.Settings:enable-webgl 


Return value 
Type: gboolean 


TRUE If WebGL support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_enable_webrtc 


since: 2.38 


Declaration 


gboolean 

webkit_settings_get_enable_webrtc ( 
WebKitSettings* settings 

) 


Description |[src] 
Get the|WebKitSettings:enable-—webrtclproperty. 


Available since: 2.38 
Gets property |WebKit2.Settings:enable-webrtc 
Return value 


Type: gboolean 


TRUE If WebRTC support is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 
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Method 


WebKit2Settingsget_enable_write_console_messages_to_stdout 


since: 2.2 


Declaration 


gboolean 

webkit_settings_get_enable_write_console_messages_to_stdout ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:enable-write-console-messages-—to-stdout property. 


Available since: 2.2 


Gets property |WebKit2.Settings:enable-write-console-messages-—to-stdout 


Return value 
Type: gboolean 


TRUE if writing console messages to stdout is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_enable_xss_auditor 


deprecated: 2.38. 


Declaration 


gboolean 

webkit_settings_get_enable_xss_auditor ( 
WebKitSettings* settings 

) 


Description 


The XSS auditor has been removed. This function returns FALSE. 
Deprecated since: 2.38. 


This function does nothing. 


Gets property |WebKit2.Settings:enable—-xss-—auditor 


Return value 
Type: gboolean 


FALSE. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 
set_media_content_types_requiring_hardware_support 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingspet_fantasy_font_family 


Declaration 


const gchar* 

webkit_settings_get_fantasy_font_family ( 
WebKitSettings* settings 

) 


Description 


Gets the WebKitSettings: fantasy-font—family property. 


Gets property |WebKit2.Settings:fantasy—font-—family 


Return value 
Type: const gchar* 
The default font family used to display content marked with fantasy font. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsget_feature_enabled 


since: 2.42 


Declaration 


gboolean 

webkit_settings_get_feature_enabled ( 
WebKitSettings* settings, 
WebKitFeature* feature 

) 


Description 


Gets whether a feature is enabled. 


Available since: 2.42 


Parameters 


feature 


Type:|(WebKitFeature 


The feature to toggle. 


The data is owned by the caller of the method. 


Return value 


Type: gboolean 


Whether the feature is enabled. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor]set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 
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Method 


WebKit2Settingsget_hardware_acceleration_policy 


since: 2.16 


Declaration 


WebKitHardwareAccelerationPolicy 

webkit_settings_get_hardware_acceleration_policy ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:hardware-acceleration-—policy property. 


Available since: 2.16 
Gets property |WebKit2.Settings:hardware-acceleration—-policy 


Return value 


Type: |WebKitHardwareAccelerationPolicy 


A WebKitHardwareAccelerationPolicy. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_javascript_can_access_clipboard 


Declaration 


gboolean 

webkit_settings_get_javascript_can_access_clipboard ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings: javascript-—can-access-—clipboard property. 


Gets property |WebKit2.Settings: javascript—can-access-clipboard 


Return value 
Type: gboolean 


TRUE If javascript-can-access-clipboard is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 
set_media_content_types_requiring_hardware_support 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsget_media_playback_allows_inline 


Declaration 


gboolean 

webkit_settings_get_media_playback_allows_inline ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:media-playback—allows-—inline property. 


Gets property |WebKit2.Settings:media-playback-allows-—inline 


Return value 
Type: gboolean 


TRUE If inline playback is allowed for media or FALSE if only fullscreen playback is allowed. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor]set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_media_playback_requires_user_gesture 
Declaration 


gboolean 

webkit_settings_get_media_playback_requires_user_gesture ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:media-playback-requires-—user-gesture property. 


Gets property |WebKit2.Settings:media-playback-requires-—user-gesture 


Return value 
Type: gboolean 


TRUE If an user gesture is needed to play or load media or FALSE if no user gesture is needed. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit 8 ettingsget_minimum_font_size 
Declaration 


guint32 

webkit_settings_get_minimum_font_size ( 
WebKitSettings* settings 

) 


Description 


Gets the WebKitSettings:minimum-font-—size property. 


Gets property |WebKit2.Settings:minimum—font-size 


Return value 
Type: guint32 


Minimum font size, in pixels. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_monospace_font_family 


Declaration 


const gchar* 

webkit_settings_get_monospace_font_family ( 
WebKitSettings* settings 

) 


Description 


Gets the WebKitSettings :monospace-font-—family property. 


Gets property |WebKit2.Settings:monospace-font-—family 


Return value 
Type: const gchar* 
Default font family used to display content marked with monospace font. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 
set_media_content_types_requiring_hardware_support 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_pictograph_font_family 


Declaration 


const gchar* 

webkit_settings_get_pictograph_font_family ( 
WebKitSettings* settings 

) 


Description 


Gets the WebKitSettings:pictograph-font-—family property. 


Gets property |WebKit2.Settings:pictograph-font-—family 


Return value 
Type: const gchar* 
The default font family used to display content marked with pictograph font. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_print_backgrounds 


Declaration 


gboolean 

webkit_settings_get_print_backgrounds ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:print-—backgrounds property. 


Gets property |WebKit2.Settings:print—-—backgrounds 


Return value 
Type: gboolean 


TRUE If background images should be printed or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_sans_serif_font_family 


Declaration 


const gchar* 

webkit_settings_get_sans_serif_font_family ( 
WebKitSettings* settings 

) 


Description 


Gets the WebKitSettings:sans-—serif—font—family property. 


Gets property |WebKit2.Settings:sans-serif—font—family 


Return value 
Type: const gchar* 
The default font family used to display content marked with sans-serif font. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_serif_font_family 


Declaration 


const gchar* 

webkit_settings_get_serif_font_family ( 
WebKitSettings* settings 

) 


Description 


Gets the WebKitSettings:serif—font—family property. 


Gets property |WebKit2.Settings:serif—font-—family 


Return value 
Type: const gchar* 
The default font family used to display content marked with serif font. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingspet_user_agent 


Declaration 


const gchar* 

webkit_settings_get_user_agent ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:user-—agent property. 


Gets property |WebKit2.Settings:user-agent 


Return value 
Type: const gchar* 
The current value of the user-agent property. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsget_zoom_text_only 


Declaration 


gboolean 

webkit_settings_get_zoom_text_only ( 
WebKitSettings* settings 

) 


Description 


Get the WebKitSettings:zoom—text-—on]y property. 


Gets property |WebKit2.Settings:zoom-text-—only 


Return value 
Type: gboolean 


TRUE If zoom level of the view should only affect the text or FALSE if all view contents should be scaled. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor]set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_allow_file_access_from_file_urls 


since: 2.10 


Declaration 


void 
webkit_settings_set_allow_file_access_from_file_urls ( 
WebKitSettings* settings, 
gboolean allowed 
) 


Description 


Set the WebKitSettings:allow-file-access—from—file-—urls property. 


Available since: 2.10 


Sets property |WebKit2.Settings:allow-file-access—from-file-urls 


Parameters 
allowed 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_allow_modal_dialogs 
Declaration 


void 
webkit_settings_set_allow_modal_dialogs ( 
WebKitSettings* settings, 
gboolean allowed 
) 


Description 


Set the WebKitSettings:allow-—modal-—dialogs property. 


Sets property |WebKit2.Settings:allow-modal-—dialogs 


Parameters 
allowed 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


set_media_content_types_requiring_hardware_support|set_media_playback_allows_inline| 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_allow_top_navigation_to_data_urls 


since: 2.28 


Declaration 


void 
webkit_settings_set_allow_top_navigation_to_data_urls ( 
WebKitSettings* settings, 
gboolean allowed 
) 


Description 


Set the WebKitSettings:allow-top-navigation-to-data-urls property. 


Available since: 2.28 


Sets property |WebKit2.Settings:allow-top-navigation-to-data-urls 


Parameters 
allowed 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_allow_universal_access_from_file_urls 


since: 2.14 


Declaration 


void 
webkit_settings_set_allow_universal_access_from_file_urls ( 
WebKitSettings* settings, 
gboolean allowed 
) 


Description 


Set the WebKitSettings:allow-universal-access—from—file-—urls property. 


Available since: 2.14 


Sets property |WebKit2.Settings:allow-universal-access—from-file-urls 


Parameters 
allowed 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_auto_load_images 
Declaration 


void 
webkit_settings_set_auto_load_images ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:auto-load-images property. 


Sets property |WebKit2.Settings:auto-load-images 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_cursive_font_family 
Declaration 


void 
webkit_settings_set_cursive_font_family ( 
WebKitSettings* settings, 
const gchar* cursive_font_family 


) 


Description 


Set the WebKitSettings:cursive-font-—family property. 


Sets property |WebKit2.Settings:cursive-font—family 


Parameters 
cursive_font_family 

Type: const gchar* 

The new default cursive font family. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_default_charset 
Declaration 


void 
webkit_settings_set_default_charset ( 
WebKitSettings* settings, 
const gchar* default_charset 


) 


Description 


Set the WebKitSettings:default—charset property. 


Sets property |WebKit2.Settings:default—charset 


Parameters 
default_charset 
Type: const gchar* 
Default charset to be set. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


set_media_content_types_requiring_hardware_support|set_media_playback_allows_inline| 
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Method 


WebKit2Settingsset_default_font_family 
Declaration 


void 
webkit_settings_set_default_font_family ( 
WebKitSettings* settings, 
const gchar* default_font_family 
) 


Description 


Set the WebKitSettings:default—font-—family property. 


Sets property |WebKit2.Settings:default—font—family 


Parameters 

default_font_family 
Type: const gchar* 
The new default font family. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_default_font_size 
Declaration 


void 
webkit_settings_set_default_font_size ( 
WebKitSettings* settings, 
guint32 font_size 


) 


Description 


Set the WebKitSettings:default—font-—size property. 


Sets property |WebKit2.Settings:default—font-size 


Parameters 
font_size 
Type: guint32 


Default font size to be set in pixels. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_default_monospace_font_size 
Declaration 


void 
webkit_settings_set_default_monospace_font_size ( 
WebKitSettings* settings, 
guint32 font_size 


) 


Description 


Set the WebKitSettings:default-—monospace-font-—size property. 


Sets property |WebKit2.Settings:default—monospace-font-size 


Parameters 
font_size 
Type: guint32 


Default monospace font size to be set in pixels. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_disable_web_security 


since: 2.40 


Declaration 


void 
webkit_settings_set_disable_web_security ( 
WebKitSettings* settings, 
gboolean disabled 
) 


Description 


Set the WebKitSettings:disable-web-security property. 


Available since: 2.40 


Sets property |WebKit2.Settings:disable-web-security 


Parameters 
disabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor]|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring image_load_setting 
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Method 


WebKit2Settingsset_draw_compositing_indicators 
Declaration 


void 
webkit_settings_set_draw_compositing_indicators ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:draw-compositing-indicators property. 


Sets property |WebKit2.Settings:draw-compositing-indicators 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 
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Method 


WebKit2Settingsset_enable_accelerated_2d_canvas 


deprecated: 2.32. since: 2.2 


Declaration 


void 
webkit_settings_set_enable_accelerated_2d_canvas ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-accelerated-2d-canvas property. 


Available since: 2.2 
Deprecated since: 2.32. 


Please do not use it in newly written code. 


Sets property |WebKit2.Settings:enable-accelerated—-2d-canvas 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


set_media_content_types_requiring_hardware_support|set_media_playback_allows_inline| 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_back_forward_navigation_gestures 


since: 2.24 


Declaration 


void 
webkit_settings_set_enable_back_forward_navigation_gestures ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-back-forward-navigation-gestures property. 


Available since: 2.24 


Sets property |WebKit2.Settings:enable—-back—-forward-navigation-gestures 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_caret_browsing 
Declaration 


void 
webkit_settings_set_enable_caret_browsing ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-caret—browsing property. 


Sets property |WebKit2.Settings:enable-caret—browsing 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_developer_extras 
Declaration 


void 
webkit_settings_set_enable_developer_extras ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-developer-—extras property. 


Sets property |WebKit2.Settings:enable-developer-extras 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_dns_prefetching 
Declaration 


void 
webkit_settings_set_enable_dns_prefetching ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-dns-prefetching property. 


Sets property |WebKit2.Settings:enable-dns-prefetching 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_encrypted_media 


since: 2.20 


Declaration 


void 
webkit_settings_set_enable_encrypted_media ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-encrypted-media property. 


Available since: 2.20 


Sets property |WebKit2.Settings:enable-encrypted-media 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_frame_flattening 


deprecated: 2.38 


Declaration 


void 
webkit_settings_set_enable_frame_flattening ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Frame flattening is no longer supported. This function does nothing. 
Deprecated since: 2.38 


Please do not use it in newly written code. 


Sets property |WebKit2.Settings:enable-frame-flattening 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_fullscreen 
Declaration 


void 
webkit_settings_set_enable_fullscreen ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-fullscreen property. 


Sets property |WebKit2.Settings:enable-fullscreen 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_html5_database 
Declaration 


void 
webkit_settings_set_enable_html5_database ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-htm15-database property. 


Sets property |WebKit2.Settings:enable-html15-database 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_html5_local_storage 
Declaration 


void 
webkit_settings_set_enable_htm1l5_local_storage ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-htm15-local-storage property. 


Sets property |WebKit2.Settings:enable—-html5-local-storage 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_hyperlink_auditing 
Declaration 


void 
webkit_settings_set_enable_hyperlink_auditing ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-hyperlink-auditing property. 


Sets property |WebKit2.Settings:enable-hyperlink-auditing 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_java 


deprecated: 2.38. 


Declaration 


void 

webkit_settings_set_enable_java ( 
WebKitSettings* settings, 
gboolean enabled 

) 


Description 


Set the WebKitSettings:enable-java property. 
Deprecated function that does nothing. 
Deprecated since: 2.38. 


This function does nothing. 


Sets property |WebKit2.Settings:enable—-java 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_javascript 
Declaration 


void 
webkit_settings_set_enable_javascript ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-javascript property. 


Sets property |WebKit2.Settings:enable—-javascript 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_javascript_markup 


since: 2.24 


Declaration 


void 
webkit_settings_set_enable_javascript_markup ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-javascript—markup property. 


Available since: 2.24 


Sets property |WebKit2.Settings:enable-javascript—markup 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_media 


since: 2.26 


Declaration 


void 

webkit_settings_set_enable_media ( 
WebKitSettings* settings, 
gboolean enabled 

) 


Description 


Set the WebKitSettings:enable-media property. 


Available since: 2.26 


Sets property |WebKit2.Settings:enable-media 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_media_capabilities 


since: 2.22 


Declaration 


void 
webkit_settings_set_enable_media_capabilities ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-media-—capabilities property. 


Available since: 2.22 


Sets property |WebKit2.Settings:enable-media-capabilities 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_media_stream 


since: 2.4 


Declaration 


void 
webkit_settings_set_enable_media_stream ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-media-—stream property. 


Available since: 2.4 


Sets property |WebKit2.Settings:enable-media-stream| 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_mediasource 


since: 2.4 


Declaration 


void 
webkit_settings_set_enable_mediasource ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description |[src] 
Set the WebKitSettings:enable-mediasource property. 


Available since: 2.4 


Sets property |WebKit2.Settings:enable-mediasource 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 
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Method 


WebKit2Settingsset_enable_mock_capture_devices 


since: 2.4 


Declaration 


void 
webkit_settings_set_enable_mock_capture_devices ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-mock-capture-devices property. 


Available since: 2.4 


Sets property |WebKit2.Settings:enable-mock-capture-devices 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


set_media_content_types_requiring_hardware_support|set_media_playback_allows_inline| 
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Method 


WebKit2Settingsset_enable_offline_web_application_cache 
Declaration 


void 


webkit_settings_set_enable_offline_web_application_cache ( 
WebKitSettings* settings, 
gboolean enabled 


) 


Description 


Set the WebKitSettings:enable-offline-web-application-cache property. 


Sets property |WebKit2.Settings:enable-offline-—web-application-cache 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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Method 


WebKit2Settingsset_enable_page_cache 
Declaration 


void 
webkit_settings_set_enable_page_cache ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-page-cache property. 


Sets property |WebKit2.Settings:enable-page-cache 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsset_enable_plugins 


deprecated: 2.32 


Declaration 


void 
webkit_settings_set_enable_plugins ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-plugins property. 
Deprecated since: 2.32 


Please do not use it in newly written code. 


Sets property |WebKit2.Settings:enable-plugins 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 
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Method 


WebKit2Settingsset_enable_private_browsing 


deprecated: 2.16. 


Declaration 


void 
webkit_settings_set_enable_private_browsing ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-private-—browsing property. 


Deprecated since: 2.16. 


Use WebKitWebView: is—ephemeral or WebKitWebContext:is-—ephemeral instead. 


Sets property |WebKit2.Settings:enable-private-browsing 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 
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WebKit2Settingsset_enable_resizable_text_areas 
Declaration 


void 
webkit_settings_set_enable_resizable_text_areas ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-resizable-text-—areas property. 


Sets property |WebKit2.Settings:enable-resizable-text—areas 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_site_specific_quirks 
Declaration 


void 
webkit_settings_set_enable_site_specific_quirks ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-site-specific—quirks property. 


Sets property |WebKit2.Settings:enable-site-specific-—quirks 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_smooth_scrolling 
Declaration 


void 
webkit_settings_set_enable_smooth_scrolling ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-smooth-scrolling property. 


Sets property |WebKit2.Settings:enable-smooth-scrolling 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_spatial_navigation 


since: 2.2 


Declaration 


void 
webkit_settings_set_enable_spatial_navigation ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description |[src] 
Set the WebKitSettings:enable-spatial-navigation property. 


Available since: 2.2 


Sets property |WebKit2.Settings:enable-spatial-navigation 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_tabs_to_links 
Declaration 


void 
webkit_settings_set_enable_tabs_to_links ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-tabs-to-links property. 


Sets property |WebKit2.Settings:enable-tabs-to-links 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_webaudio 
Declaration 


void 
webkit_settings_set_enable_webaudio ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:enable-webaudio property. 


Sets property |WebKit2.Settings:enable—-webaudio 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_webel 
Declaration 


void 

webkit_settings_set_enable_webgl ( 
WebKitSettings* settings, 
gboolean enabled 

) 


Description 


Set the WebKitSettings:enable-webgl property. 


Sets property |WebKit2.Settings:enable-webgl 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_webrtc 


since: 2.38 


Declaration 


void 

webkit_settings_set_enable_webrtc ( 
WebKitSettings* settings, 
gboolean enabled 

) 


Description |[src] 
Set thelWebKitSettings:enable—webrtc|property. 


Setting this property to TRUE implies the media-stream web-setting will also be enabled. 


Available since: 2.38 


Sets property |WebKit2.Settings:enable-webrtc 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_write_console_messages_to_stdout 


since: 2.2 


Declaration 


void 
webkit_settings_set_enable_write_console_messages_to_stdout ( 
WebKitSettings* settings, 
gboolean enabled 


) 


Description 


Set the WebKitSettings:enable-write-console-messages-—to-stdout property. 


Available since: 2.2 


Sets property |WebKit2.Settings:enable-write-console-messages-—to-stdout 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_enable_xss_auditor 


deprecated: 2.38. 


Declaration 


void 
webkit_settings_set_enable_xss_auditor ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


The XSS auditor has been removed. This function does nothing. 
Deprecated since: 2.38. 


This function does nothing. 


Sets property |WebKit2.Settings:enable-xss-—auditor 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


set_media_content_types_requiring_hardware_support|set_media_playback_allows_inline| 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_fantasy_font_family 
Declaration 


void 
webkit_settings_set_fantasy_font_family ( 
WebKitSettings* settings, 
const gchar* fantasy_font_family 
) 


Description 


Set the WebKitSettings:fantasy—font-—family property. 


Sets property |WebKit2.Settings:fantasy—font—family 


Parameters 
fantasy_font_family 

Type: const gchar* 

The new default fantasy font family. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_feature_enabled 


since: 2.42 


Declaration 


void 

webkit_settings_set_feature_enabled ( 
WebKitSettings* settings, 
WebKitFeature* feature, 
gboolean enabled 

) 


Description 


Enables or disables a feature. 


The current status of the feature can be determined with 


webkit_settings_get_feature_enabled()| To reset a feature to its initial status, pass the 


value returned by|webkit_feature_get_default_value () Jas the enabled parameter. 


Available since: 2.42 


Parameters 


feature 


Type:|(WebKitFeature 


The feature to toggle. 


The data is owned by the caller of the method. 


enabled 
Type: gboolean 


Whether the feature will be enabled. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
set_default_value]get_details|get_identifier 


Generated by[gi-docgen]2023.3 


Method 
WebKit2Featureget_default_value 
since: 2.42 


Declaration 


gboolean 
webkit_feature_get_default_value ( 
WebKitFeature* feature 


) 


Description 


Gets whether the feature is enabled by default. 


The default value may be used by applications which include user interface to toggle features to restore its 
settings to their defaults. Note that whether a feature is actually enabled must be checked with 
webkit_settings_ get_feature_enabled() 


Available since: 2.42 


Return value 


Type: gboolean 


Whether the feature is enabled by default. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
set_default_value]get_details|get_identifier 


Generated by[gi-docgen]2023.3 


Method 
WebKit2Featureget_category 
since: 2.42 


Declaration 


const char* 
webkit_feature_get_category ( 
WebKitFeature* feature 


) 


Description 


Gets the category of the feature. 


Applications which include user interface to toggle features may want to use the category to group related 
features together. 


Available since: 2.42 
Return value 
Type: const char* 


Feature category. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
set_default_value]get_details|get_identifier 


Generated by[gi-docgen]2023.3 


Method 
WebKit2Featureget_details 
since: 2.42 


Declaration 


const char* 
webkit_feature_get_details ( 
WebKitFeature* feature 


) 


Description 


Gets a description for the feature. 


The detailed description should be considered an additional clarification on the purpose of the feature, to 
be used as complementary aid to be displayed along the feature name returned by 


webkit_feature_get_name ()| The returned string is suitable to be displayed to end users, but it 


should not be relied upon being localized. 
Note that some features may not have a detailed description, and NULL is returned in this case. 


Available since: 2.42 


Return value 
Type: const char* 
Feature description. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
set_default_value]get_details|get_identifier 


Generated by[gi-docgen]2023.3 


Method 
WebKit2Featureget_identifier 
since: 2.42 


Declaration 


const char* 
webkit_feature_get_identifier ( 
WebKitFeature* feature 


) 


Description 


Gets a string that uniquely identifies the feature. 
Available since: 2.42 

Return value 

Type: const char* 

The identifier string for the feature. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
set_default_value]get_details|get_identifier 


Generated by[gi-docgen]2023.3 


Method 
WebKit2Featureget_name 
since: 2.42 


Declaration 


const char* 
webkit_feature_get_name ( 
WebKitFeature* feature 


) 


Description 


Gets a short name for the feature. 


The returned string is suitable to be displayed to end users, but it should not be relied upon 
being localized. 


Note that some features may not have a short name, and NULL is returned in this case. 


Available since: 2.42 


Return value 
Type: const char* 
Short feature name. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
set_default_value]get_details|get_identifier 


Generated by[gi-docgen]2023.3 


Method 
WebKit2Featureget_status 
since: 2.42 


Declaration 


WebKitFeatureStatus 
webkit_feature_get_status ( 
WebKitFeature* feature 


) 


Description|[src] 
Gets the status of the feature. 


Available since: 2.42 


Return value 


Type: |WebKitFeatureStatus 


Feature status. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


set_default_value]get_details|get_identifier 
Generated by 2023.3 


Method 


WebKit2F eatureref 


since: 2.42 


Declaration 


WebKitFeature* 
webkit_feature_ref ( 
WebKitFeature* feature 


) 


Description 


Atomically acquires a reference on the given feature. 
This function is MT-safe and may be called from any thread. 


Available since: 2.42 


Return value 


Type: |WebKitFeature 


The same feature with an additional reference. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


set_default_value]get_details|get_identifier 
Generated by 2023.3 


Method 
WebKit2Featureunref 
since: 2.42 


Declaration 


void 
webkit_feature_unref ( 
WebKitFeature* feature 


) 


Description 


Atomically releases a reference on the given feature. 


If the reference was the last, the resources associated to the feature are freed. This function is MT-safe 
and may be called from any thread. 


Available since: 2.42 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_hardware_acceleration_policy 


since: 2.16 


Declaration 


void 

webkit_settings_set_hardware_acceleration_policy ( 
WebKitSettings* settings, 
WebKitHardwareAccelerationPolicy policy 

) 


Description 


Set the WebKitSettings:hardware-acceleration-policy property. 


Available since: 2.16 


Sets property |WebKit2.Settings:hardware-acceleration—-policy 


Parameters 
policy 


Type:|(WebKitHardwareAccelerationPolicy 


A WebKitHardwareAccelerationPolicy. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_javascript_can_access_clipboard 
Declaration 


void 
webkit_settings_set_javascript_can_access_clipboard ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings: javascript-—can-access-—clipboard property. 


Sets property |WebKit2.Settings: javascript—can-access-—clipboard 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_javascript_can_open_windows_automatically 
Declaration 


void 


webkit_settings_set_javascript_can_open_windows_automatically ( 
WebKitSettings* settings, 
gboolean enabled 

) 


Description 


Set the WebKitSettings: javascript—can-open-windows-—automatically property. 


Sets 
property 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen|2023.3 
Method 


WebKit2Settingsset_load_icons_ignoring_image_load_setting 


deprecated: 2.42 


Declaration 


void 
webkit_settings_set_load_icons_ignoring_image_load_setting ( 
WebKitSettings* settings, 
gboolean enabled 


) 


Description 


Setting no longer supported. This function does nothing. 
Deprecated since: 2.42 


Please do not use it in newly written code. 


Sets property |WebKit2.Settings:load-icons—ignoring-image-load-setting 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsket_media_content_types_requiring_hardware_support 


since: 2.30 


Declaration 


void 
webkit_settings_set_media_content_types_requiring_hardware_support ( 
WebKitSettings* settings, 
const gchar* content_types 


) 


Description 


Set the WebKitSettings:media-content-types-requiring-hardware-support 
property. 


Available since: 2.30 


Sets 
property 


Parameters 
content_types 
Type: const gchar* 


List of media content types requiring hardware support split by semicolons (:) or NULL to use the 
default value. 


The argument can be NULL. 
The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor]set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_media_playback_allows_inline 
Declaration 


void 
webkit_settings_set_media_playback_allows_inline ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:media-playback-—allows-—inline property. 


Sets property |WebKit2.Settings:media-playback-allows-—inline 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_media_playback_requires_user_gesture 
Declaration 


void 
webkit_settings_set_media_playback_requires_user_gesture ( 
WebKitSettings* settings, 
gboolean enabled 
) 


Description 


Set the WebKitSettings:media-playback-requires-—user-gesture property. 


Sets property |WebKit2.Settings:media-—playback-requires-—user-gesture 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_minimum_font_size 
Declaration 


void 
webkit_settings_set_minimum_font_size ( 
WebKitSettings* settings, 
guint32 font_size 


) 


Description 


Set the WebKitSettings:minimum-font-—size property. 


Sets property |WebKit2.Settings:minimum—font-size 


Parameters 
font_size 
Type: guint32 


Minimum font size to be set in pixels. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_monospace_font_family 
Declaration 


void 
webkit_settings_set_monospace_font_family ( 
WebKitSettings* settings, 
const gchar* monospace_font_family 


) 


Description 


Set the WebKitSettings:monospace-font-—family property. 


Sets property |WebKit2.Settings:monospace-font-—family 


Parameters 
monospace_font_family 

Type: const gchar* 

The new default monospace font family. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 
set_media_content_types_requiring_hardware_support 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_pictograph_font_family 


Declaration 


void 
webkit_settings_set_pictograph_font_family ( 
WebKitSettings* settings, 
const gchar* pictograph_font_family 
) 


Description 


Set the WebKitSettings:pictograph-font—family property. 


Sets property |WebKit2.Settings:pictograph-—font—family 


Parameters 
pictograph_font_family 

Type: const gchar* 

The new default pictograph font family. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_load_icons_ignoring_image_load_setting 


set_media_playback_requires_user_gesture set_monospace_font_famil 
set_pictograph_font_family}set_print_backgrounds]set_sans_serif_font_family|set_serif_font_famil 
lset_user_agentset_user_agent_with_application_details]set_zoom_text_onl 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_print_backgrounds 


Declaration 


void 
webkit_settings_set_print_backgrounds ( 
WebKitSettings* settings, 
gboolean print_backgrounds 
) 


Description 


Set the WebKitSettings:print—backgrounds property. 


Sets property |WebKit2.Settings:print-—backgrounds 


Parameters 
print_backgrounds 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_sans_serif_font_family 
Declaration 


void 
webkit_settings_set_sans_serif_font_family ( 
WebKitSettings* settings, 
const gchar* sans_serif_font_family 


) 


Description 


Set the WebKitSettings:sans-—serif—font—family property. 


Sets property |WebKit2.Settings:sans-—serif—font—family 


Parameters 


sans_serif_font_family 


Type: const gchar* 


The new default sans-serif font family. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_serif_font_family 
Declaration 


void 
webkit_settings_set_serif_font_family ( 
WebKitSettings* settings, 
const gchar* serif_font_family 


) 


Description 


Set the WebKitSettings:serif—font-—family property. 


Sets property |WebKit2.Settings:serif—font—family 


Parameters 
serif_font_family 

Type: const gchar* 

The new default serif font family. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_user_agent 
Declaration 


void 

webkit_settings_set_user_agent ( 
WebKitSettings* settings, 
const gchar* user_agent 


) 


Description 


Set the WebKitSettings:user-—agent property. 


Sets property |WebKit2.Settings:user-agent 


Parameters 
user_agent 
Type: const gchar* 
The new custom user agent string or NULL to use the default user agent. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_user_agent_with_application_details 
Declaration 


void 
webkit_settings_set_user_agent_with_application_details ( 
WebKitSettings* settings, 
const gchar* application_name, 
const gchar* application_version 


) 


Description 


Set the WebKitSettings:user-—agent property by appending the application details. 


Set the WebKitSettings:user-—agent property by appending the application details to the default 
user agent. If no application name or version is given, the default user agent used will be used. If only the 
version is given, the default engine version is used with the given application name. 


Parameters 
application_name 
Type: const gchar* 
The application name used for the user agent or NULL to use the default user agent. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


application_version 
Type: const gchar* 
The application version for the user agent or NULL to user the default version. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_allow_top_navigation_to_data_urls 
get_enable_back_forward_navigation_gestures 
get_load_icons_ ignoring image_load_setting 
get_media_content_types_requiring_hardware_support 
get_media_playback_requires_user_gesture 
get_user_agent 


set_enable_write_console_messages_to_stdout|set_enable_xss_auditor|set_fantasy_font_famil 
set_feature_enabled|set_hardware_acceleration_policy]|set_javascript_can_access_clipboard 
set_javascript_can_open_windows_automatically}set_load_icons_ignoring_ image_load_setting 


Generated by[gi-docgen]2023.3 
Method 


WebKit2Settingsset_zoom_text_only 
Declaration 


void 
webkit_settings_set_zoom_text_only ( 
WebKitSettings* settings, 
gboolean zoom_text_only 


) 


Description 


Set the WebKitSettings: zoom—-text—on1]1y property. 


Sets property |WebKit2.Settings:zoom-text-only 


Parameters 
zoom_text_only 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:allow-file-access-from-file-urls 


since: 2.10 


Declaration 


property allow-file-access-—from-file-urls: gboolean [ read, write, construct ] 


Description 


Whether file access is allowed from file URLs. By default, when something is loaded in a 
WebKitWebView using a file URI, cross origin requests to other file resources are not allowed. This 


setting allows you to change that behaviour, so that it would be possible to do a XMLHttpRequest of a 
local file, for example. 


Type: 


Available since: 


Default value 
Getter method 


Setter method 


Flags 


Readable 
Writable 
Construct 


Construct only 


gboolean 


2.10 


FALSE 


webkit_settings_get_allow_file access _from_file_urls() 


webkit_settings_set_allow_file_access_from_file_urls() 


yes 


yes 


yes 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstallow-modal-dialogs 


unstable since: 4.1 


Declaration 


property allow-modal-dialogs: gboolean [ read, write, construct ] 


Description 


Determine whether it’s allowed to create and run modal dialogs from a WebKitWebView through 
JavaScript with window.showModalDialog. If it’s set to FALSE, the associated WebKitWebView won’t 
be able to create new modal dialogs, so not even the WebKitWebView: : create signal will 

be emitted. 


Type: gboolean 


Available since: 4.1 


Default value FALSE 


Getter method |webkit_settings_get_allow_modal_dialogs() 


Setter method |webkit_settings_set_allow_modal_dialogs() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstallow-top-navigation-to-data-urls 


since: 2.28 


Declaration 


property allow-top-navigation-to-data-urls: gboolean [ read, write, construct ] 


Description 


Whether or not the top frame is allowed to navigate to data URLs. It is disabled by default due to the risk 
it poses when loading untrusted URLs, with data URLs being used in scamming and phishing attacks. In 
contrast, a scenario where it could be enabled could be an app that embeds a WebView and you have 
control of the pages being show instead of a generic browser. 


Type: gboolean 
Available since: 2.28 


Default value FALSE 
Getter method |webkit_settings_get_allow_top_navigation_to_data_urls() 


Setter method webkit_settings_set_allow_top_navigation_to_data_urls() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstallow-universal-access-from-file-urls 


since: 2.14 


Declaration 


property allow-universal-access-—from-file-urls: gboolean [ read, write, construct ] 


Description 


Whether or not JavaScript running in the context of a file scheme URL should be allowed to access 
content from any origin. By default, when something is loaded in a WebKit WebView using a file scheme 
URL, access to the local file system and arbitrary local storage is not allowed. This setting allows you to 
change that behaviour, so that it would be possible to use local storage, for example. 


Type: gboolean 
Available since: 2.14 


Default FALSE 
value 
Getter : : = 
webkit_settings_get_allow_universal_access_from_file_urls() 
method 
Setter : 
webkit_settings_set_allow_universal_access_from_file_urls() 
method 
Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstauto-load-images 


unstable since: 4.1 


Declaration 


property auto-load-images: gboolean [ read, write, construct ] 


Description 


Determines whether images should be automatically loaded or not. On devices where network bandwidth 
is of concern, it might be useful to turn this property off. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_settings_get_auto_load_images () 


Setter method webkit_settings_set_auto_load_images () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstcursive-font-family 


unstable since: 4.1 


Declaration 


property cursive-font-family: utf8 [ read, write, construct ] 


Description 


The font family used as the default for content using a cursive font. 


Type: 


Available since: 


Default value 
Getter method 


Setter method 


Flags 


Readable 
Writable 
Construct 


Construct only 


gchar* 


4.1 


serif 


webkit_settings_get_cursive_font_family () 


webkit_settings_set_cursive_font_family () 


yes 
yes 
yes 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstdefault-charset 


unstable since: 4.1 


Declaration 


property default-charset: utf8 [ read, write, construct ] 


Description 


The default text charset used when interpreting content with an unspecified charset. 


Type: gchar* 


Available since: 4.1 


Default value 1s0-8859-] 


Getter method |webkit_settings_get_default_charset () 


Setter method webkit_settings_set_default_charset () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:default-font-family 


unstable since: 4.1 


Declaration 


property default-—font-family: utf8 [ read, write, construct ] 


Description 


The font family to use as the default for content that does not specify a font. 


Type: 


Available since: 


Default value 
Getter method 


Setter method 


Flags 


Readable 
Writable 
Construct 


Construct only 


gchar* 


4.1 


sans-serif 


webkit_settings_get_deft font_family() 


webkit_settings_set_default_font_family () 


yes 
yes 
yes 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstdefault-font-size 


unstable since: 4.1 


Declaration 


property default-—font-size: guint [ read, write, construct ] 


Description 


The default font size in pixels to use for content displayed if no font size is specified. 


Type: guint 


Available since: 4.1 


Default value 16 


Getter method |webkit_settings_get_det font_size() 


Setter method webkit_settings_set_default_font_size() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingst default-monospace-font-size 


unstable since: 4.1 


Declaration 


property default-monospace-font-size: guint [ read, write, construct ] 


Description 


The default font size in pixels to use for content displayed in monospace font if no font size is specified. 


Type: guint 


Available since: 4.1 


Default value 13 


Getter method |webkit_settings_get_default_monospace_font_size() 


Setter method webkit_settings_set_default_monospace_font_size() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstdisable-web-security 


since: 2.40 


Declaration 


property disable-web-security: gboolean [ read, write, construct ] 


Description 


Enable or disable support for Web Security on pages. 


This setting disables the same-origin policy, allowing every website full control over all other websites. 
This is for use in special environments where you wish to disable all security and allow websites to hack 
each other. It is impossible to use this setting securely. 


Type: gboolean 
Available since: 2.40 


Default value FALSE 
Getter method |webkit_settings_get_disable_web_security () 


Setter method webkit_settings_set_disable web_security() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:draw-compositing-indicators 


unstable since: 4.1 


Declaration 


property draw-compositing-indicators: gboolean [ read, write, construct ] 


Description 


Whether to draw compositing borders and repaint counters on layers drawn with accelerated compositing. 
This is useful for debugging issues related to web content that is composited with the GPU. 


Type: gboolean 


Available since: 4.1 


Default value FALSE 
Getter method |webkit_settings_get_draw_compositing_indicators () 


Setter method webkit_settings_set_draw_compositing_indicators() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-accelerated-2d-canvas 


deprecated: 2.32. since: 2.2 


Declaration 


property enable-accelerated-2d-canvas: gboolean [ read, write, construct ] 


Description 


Enable or disable accelerated 2D canvas. Accelerated 2D canvas is only available if WebKit was compiled 
with a version of Cairo including the unstable CairoGL API. When accelerated 2D canvas is enabled, 
WebKit may render some 2D canvas content using hardware accelerated drawing operations. 


Type: gboolean 
Available since: 2.2 
Deprecated since: 2.32. 


Please do not use it in newly written code. 


Default value FALSE 


Getter method |webkit_settings_get_enable_accelerated_2d_canvas () 


Setter method webkit_settings_set_enable_accelerated_2d_canvas () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-back-forward-navigation-gestures 


since: 2.24 


Declaration 


property enable-back-forward-navigation-gestures: gboolean [ read, write, construct ] 


Description 


Enable or disable horizontal swipe gesture for back-forward navigation. 


Type: gboolean 
Available since: 2.24 


Default FALSE 

value 

Getter 

methed webkit_settings_get_enable_ back_forward_navigation_gestures () 

Setter : : 

method webkit_settings_set_enable back_forward_navigation_gestures () 
Flags 

Readable yes 

Writable yes 

Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstenable-caret-browsing 


unstable since: 4.1 


Declaration 


property enable-caret-—browsing: gboolean [ read, write, construct ] 


Description 


Whether to enable accessibility enhanced keyboard navigation. 


Type: gboolean 


Available since: 4.1 


Default value FALSE 


Getter method |webkit_settings_get_enable_caret_browsing() 
Setter method webkit_settings_set_enable_caret_browsing() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-developer-extras 


unstable since: 4.1 


Declaration 


property enable-developer-extras: gboolean [ read, write, construct ] 


Description 


Determines whether or not developer tools, such as the Web Inspector, are enabled. 


Type: gboolean 


Available since: 4.1 


Default value FALSE 


Getter method |webkit_settings_get_enable_developer_extras() 


Setter method webkit_settings_set_enable developer_extras () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-dns-prefetching 


unstable since: 4.1 


Declaration 


property enable-dns-prefetching: gboolean [ read, write, construct ] 


Description 


Determines whether or not to prefetch domain names. DNS prefetching attempts to resolve domain names 
before a user tries to follow a link. 


Type: gboolean 


Available since: 4.1 


Default value FALSE 


Getter method |webkit_settings_get_enable_dns_prefetching() 


Setter method webkit_settings_set_enable _dns_prefetching() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingst enable-encrypted-media 


since: 2.20 


Declaration 


property enabl ncrypted-media: gboolean [ read, write, construct ] 


Description 


Enable or disable support for Encrypted Media API on pages. EncryptedMedia is an experimental 
JavaScript API for playing encrypted media in HTML. This property will only work as intended if the 
EncryptedMedia feature is enabled at build time with the ENABLE_ENCRYPTED_MEDIA flag. 


See https://www.w3.org/TR/encrypted-media/ 


Type: gboolean 
Available since: 2.20 


Default value FALSE 
Getter method |webkit_settings_get_enable_encrypted_media () 


Setter method webkit_settings_set_enable_encrypted_media () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstenable-frame-flattening 


unstable deprecated: 2.38 since: 4.1 


Declaration 


property enable-frame-flattening: gboolean [ read, write, construct ] 


Description 


Frame flattening is no longer supported. This property does nothing. 


Type: gboolean 
Available since: 4.1 
Deprecated since: 2.38 


Please do not use it in newly written code. 


Default value FALSE 


Getter method |webkit_settings_get_enable_frame_flattening() 


Setter method webkit_settings_set_enable frame_flattening() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-fullscreen 


unstable since: 4.1 


Declaration 


property enable-fullscreen: gboolean [ read, write, construct ] 


Description 


Whether to enable the Javascript Fullscreen API. The API allows any HTML element to request fullscreen 
display. See also the current draft of the spec: http://www.w3.org/TR/fullscreen/ 


Type: gboolean 


Available since: 4.1 


Default value TRUE 
Getter method |webkit_settings_get_enable_ fullscreen () 


Setter method webkit_settings_set_enable fullscreen () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingst enable-html5-database 


unstable since: 4.1 


Declaration 


property enable-html5-database: gboolean [ read, write, construct ] 


Description 


Whether to enable HTMLS client-side SQL database support (IndexedDB). 


Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_settings_get_enable_htm15_database() 
Setter method webkit_settings_set_enable_ html15_database() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstenable-html5-local-storage 


unstable since: 4.1 


Declaration 


property enable-html5-local-storage: gboolean [ read, write, construct ] 


Description 


Whether to enable HTMLS5 local storage support. Local storage provides simple synchronous 
storage access. 


HTMLS local storage specification is available at http://dev.w3.org/htm15/webstorage/. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_settings_get_enable_html15_local_storage() 


Setter method webkit_settings_set_enable_ html15_local_storage() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-hyperlink-auditing 


unstable since: 4.1 


Declaration 


property enable-hyperlink-auditing: gboolean [ read, write, construct ] 


Description 


Determines whether or not hyperlink auditing is enabled. 


The hyperlink auditing specification is available 
at http://www.whatwg.org/specs/web-apps/current-work/multipage/links.html#hyperlink-auditing. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_settings_get_enable_hyperlink_auditing() 


Setter method webkit_settings_set_enable_hyperlink_auditing() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingszenable-java 


unstable deprecated: 2.38 since: 4.1 


Declaration 


property enable-java: gboolean [ read, write, construct ] 


Description 


Determines whether or not Java is enabled on the page. 


Type: gboolean 
Available since: 4.1 
Deprecated since: 2.38 


Please do not use it in newly written code. 


Default value FALSE 
Getter method |webkit_settings_get_enable_java() 


Setter method webkit_settings_set_enable_ java () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstenable-javascript 


unstable since: 4.1 


Declaration 


property enable-javascript: gboolean [ read, write, construct ] 


Description 


Determines whether or not JavaScript executes within a page. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_settings_get_enable_javascript () 
Setter method webkit_settings_set_enable javascript () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-javascript-markup 


since: 2.24 


Declaration 


property enable-javascript-markup: gboolean [ read, write, construct ] 


Description 


Determines whether or not JavaScript markup is allowed in document. When this setting is disabled, all 
JavaScript-related elements and attributes are removed from the document during parsing. Note that 
executing JavaScript is still allowed if WebKitSettings:enable-javascript is TRUE. 


Type: gboolean 
Available since: 2.24 


Default value TRUE 
Getter method |webkit_settings_get_enable_javascript_markup () 


Setter method webkit_settings_set_enable _javascript_markup () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-media 


since: 2.26 


Declaration 


property enable-media: gboolean [ read, write, construct ] 


Description 


Enable or disable support for media playback on pages. This setting is enabled by default. Disabling it 
means <audio>, <track> and <video> elements will have playback support disabled. 


Type: gboolean 
Available since: 2.26 


Default value TRUE 
Getter method |webkit_settings_get_enable_media() 


Setter method webkit_settings_set_enable media () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-media-capabilities 


since: 2.22 


Declaration 


property enable-media-capabilities: gboolean [ read, write, construct ] 


Description 


Enable or disable support for MediaCapabilities on pages. This specification intends to provide APIs to 
allow websites to make an optimal decision when picking media content for the user. The APIs will 
expose information about the decoding and encoding capabilities for a given format but also output 
capabilities to find the best match based on the deviceas display. 


See also https://wicg.github.io/media-capabilities/ 


Type: gboolean 
Available since: 2.22 


Default value FALSE 


Getter method |webkit_settings_get_enable_media_capabilities () 


Setter method webkit_settings_set_enable media_capabilities() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingst enable-media-stream 


since: 2.4 


Declaration 


property enable-media-stream: gboolean [ read, write, construct ] 


Description 


Enable or disable support for MediaStream on pages. MediaStream is an experimental proposal for 
allowing web pages to access audio and video devices for capture. 


See also http://dev.w3.org/201 1/webrtc/editor/getusermedia.html. 


Type: gboolean 


Available since: 2.4 


Default value FALSE 
Getter method |webkit_settings_get_enable_media_stream() 


Setter method webkit_settings_set_enable media_stream() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingst enable-mediasource 


since: 2.4 


Declaration 


property enable-mediasource: gboolean [ read, write, construct ] 


Description 


Enable or disable support for MediaSource on pages. MediaSource extends HTMLMediaElement to allow 
JavaScript to generate media streams for playback. 


See also http://www.w3.org/TR/media-source/ 


Type: gboolean 


Available since: 2.4 


Default value TRUE 
Getter method |webkit_settings_get_enable_mediasource() 


Setter method webkit_settings_set_enable mediasource() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingst enable-mock-capture-devices 


since: 2.24 


Declaration 


property enable-mock-capture-devices: gboolean [ read, write, construct ] 


Description 


Enable or disable the Mock Capture Devices. Those are fake Microphone and Camera devices to be used 
as MediaStream sources. 


Type: gboolean 
Available since: 2.24 


Default value FALSE 


Getter method |webkit_settings_get_enable_mock_capture_devices () 
Setter method webkit_settings_set_enable _mock_capture_devices () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-offline-web-application-cache 


unstable since: 4.1 


Declaration 


property enable-offline-web-application-cache: gboolean [ read, write, construct ] 


Description 


Whether to enable HTMLS5S offline web application cache support. Offline web application cache allows 
web applications to run even when the user is not connected to the network. 


HTMLS offline web application specification is available at http://dev.w3.org/html5/spec/offline.html. 


Type: gboolean 


Available since: 4.1 


Default 
re TRUE 

value 

Getter ; : ; : 
webkit_settings_get_enable offline web_application_cache() 

method 

Setter - = : 
webkit_settings_set_enable offline _web_application_cache() 

method 

Flags 

Readable yes 

Writable yes 

Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-page-cache 


unstable since: 4.1 


Declaration 


property enable-page-cache: gboolean [ read, write, construct ] 


Description 


Enable or disable the page cache. Disabling the page cache is generally only useful for special 
circumstances like low-memory scenarios or special purpose applications like static HTML viewers. This 
setting only controls the Page Cache, this cache is different than the disk-based or memory-based 
traditional resource caches, its point is to make going back and forth between pages much faster. For 
details about the different types of caches and their purposes 
see: http://webkit.org/blog/427/webkit-page-cache-i-the-basics/ 

Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_settings_get_enable_page_cache () 


Setter method webkit_settings_set_enable page_cache () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-plugins 


unstable deprecated: 2.32 since: 4.1 


Declaration 


property enable-plugins: gboolean [ read, write, construct ] 


Description 


Determines whether or not plugins on the page are enabled. 


Type: gboolean 
Available since: 4.1 
Deprecated since: 2.32 


Please do not use it in newly written code. 


Default value FALSE 
Getter method |webkit_settings_get_enable_plugins() 


Setter method webkit_settings_set_enable plugins () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-private-browsing 


unstable deprecated: 2.16. since: 4.1 


Declaration 


property enable-private-browsing: gboolean [ read, write, construct ] 


Description 


Determines whether or not private browsing is enabled. Private browsing will disable history, cache and 
form auto-fill for any pages visited. 


Type: gboolean 
Available since: 4.1 
Deprecated since: 2.16. 


Use WebKitWebView:is—ephemeral or WebKitWebsiteDataManager:is-—ephemeral 
instead. 

Default value FALSE 

Getter method |webkit_settings_get_enable_private_browsing() 


Setter method webkit_settings_set_enable_ private_browsing() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-resizable-text-areas 


unstable since: 4.1 


Declaration 


property enable-resizable-text-—areas: gboolean [ read, write, construct ] 


Description 


Determines whether or not text areas can be resized. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_settings_get_enable_resizable_text_areas() 
Setter method webkit_settings_set_enable resizable _text_areas() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingst enable-site-specific-quirks 


unstable since: 4.1 


Declaration 


property enable-site-specific-quirks: gboolean [ read, write, construct ] 


Description 


Whether to turn on site-specific quirks. Turning this on will tell WebKit to use some site-specific 
workarounds for better web compatibility. For example, older versions of MediaWiki will incorrectly send 
to WebKit a CSS file with KHTML workarounds. By turning on site-specific quirks, WebKit will 
special-case this and other cases to make some specific sites work. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 
Getter method |webkit_settings_get_enable_site_specific_quirks() 


Setter method webkit_settings_set_enable_ site _specific_quirks() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-smooth-scrolling 


unstable since: 4.1 


Declaration 


property enable-smooth-scrolling: gboolean [ read, write, construct ] 


Description 


Enable or disable smooth scrolling. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_settings_get_enable_smooth_scrolling() 


Setter method webkit_settings_set_enable_ smooth_scrolling() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingst enable-spatial-navigation 


since: 2.4 


Declaration 


property enable-spatial-navigation: gboolean [ read, write, construct ] 


Description 


Whether to enable Spatial Navigation. This feature consists in the ability to navigate between focusable 
elements in a Web page, such as hyperlinks and form controls, by using Left, Right, Up and Down arrow 
keys. For example, if an user presses the Right key, heuristics determine whether there is an element they 
might be trying to reach towards the right, and if there are multiple elements, which element they 
probably wants. 


Type: gboolean 


Available since: 2.4 


Default value FALSE 


Getter method |webkit_settings_get_enable_spatial_navigation() 


Setter method webkit_settings_set_enable_spatial_navigation() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstenable-tabs-to-links 


unstable since: 4.1 


Declaration 


property enable-tabs-to-links: gboolean [ read, write, construct ] 


Description 


Determines whether the tab key cycles through the elements on the page. When this setting is enabled, 
users will be able to focus the next element in the page by pressing the tab key. If the selected element is 
editable, then pressing tab key will insert the tab character. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 
Getter method |webkit_settings_get_enable_tabs_to_links () 


Setter method webkit_settings_set_enable _tabs_to_links() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-webaudio 


unstable since: 4.1 


Declaration 


property enable-webaudio: gboolean [ read, write, construct ] 


Description 


Enable or disable support for WebAudio on pages. WebAudio is an API for processing and synthesizing 
audio in web applications 


See also https://webaudio.github.io/web-audio-api. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 
Getter method |webkit_settings_get_enable_webaudio() 


Setter method webkit_settings_set_enable webaudio() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings;enable-webgl 


unstable since: 4.1 


Declaration 


property enable-webgl: gboolean [ read, write, construct ] 


Description 


Enable or disable support for WebGL on pages. WebGL enables web content to use an API based on 
OpenGL ES 2.0. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 
Getter method |webkit_settings_get_enable_webgl () 


Setter method webkit_settings_set_enable_ webgl () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-webrtc 


since: 2.38 


Declaration 


property enable-webrtc: gboolean [ read, write, construct ] 


Description 


Enable WebRTC support for loaded pages. 


Enabling this setting implies thathWebKitSettings:enable-media—st ream|will be enabled 


as well. 


See also https://www.w3.org/TR/webrtc/ 


Type: gboolean 
Available since: 2.38 


Default value FALSE 
Getter method |webkit_settings_get_enable_webrtc() 


Setter method webkit_settings_set_enable _webrtc() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-write-console-messages-to-stdout 


since: 2.2 


Declaration 


property enable-write-console-messages-to-stdout: gboolean [ read, write, construct ] 


Description 


Enable or disable writing console messages to stdout. These are messages sent to the console with 
console.log and related methods. 


Type: gboolean 


Available since: 2.2 


Default FALSE 
value 
Getter - : 
Fasiied webkit_settings_get_enable write console _messages_to_stdout () 
Setter : - 
webkit_settings_set_enable write console messages_to_stdout () 
method 
Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:enable-xss-auditor 


unstable deprecated: 2.38 since: 4.1 


Declaration 


property enable-xss-auditor: gboolean [ read, write, construct ] 


Description 


Whether to enable the XSS auditor. This feature filters some kinds of reflective XSS attacks on vulnerable 
web sites. 


Type: gboolean 
Available since: 4.1 
Deprecated since: 2.38 


Please do not use it in newly written code. 


Default value TRUE 
Getter method |webkit_settings_get_enable_xss_auditor() 


Setter method webkit_settings_set_enable_xss_auditor() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstfantasy-font-family 


unstable since: 4.1 


Declaration 


property fantasy-font-family: utf8 [ read, write, construct ] 


Description 


The font family used as the default for content using a fantasy font. 


Type: 


Available since: 


Default value 
Getter method 


Setter method 


Flags 


Readable 
Writable 
Construct 


Construct only 


gchar* 


4.1 


serif 


webkit_settings_get_fantasy_font_family() 


webkit_settings_set_fantasy_font_family () 


yes 
yes 
yes 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:hardware-acceleration-policy 


since: 2.16 


Declaration 


property hardware-acceleration-policy: WebKit2.HardwareAccelerationPolicy [ read, write, construct ] 


Description 


The WebKitHardwareAccelerationPolicy to decide how to enable and disable hardware 
acceleration. Disabling hardware acceleration might cause some websites to not render correctly or 
consume more CPU. 


Note that changing this setting might not be possible if hardware acceleration is not supported by the 
hardware or the system. In that case, you can get the value to know the actual policy being used, but 
changing the setting will not have any effect. 


Type: WebKitHardwareAccelerationPolicy 
Available since: 2.16 


Default value WEBKIT_ HARDWARE ACCELERATION _POLICY_ALWAYS 
Getter method |webkit_settings_get_hardware_acceleration_policy () 


Setter method webkit_settings_set_hardware_acceleration_policy () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingst javascript-can-access-clipboard 


unstable since: 4.1 


Declaration 


property javascript-—can-access-clipboard: gboolean [ read, write, construct ] 


Description 


Whether JavaScript can access the clipboard. The default value is FALSE. If set to TRUE, 
document.execCommand() allows cut, copy and paste commands. 


Type: gboolean 


Available since: 4.1 


Default value FALSE 
Getter method |webkit_settings_get_javascript_can_access_clipboard() 


Setter method webkit_settings_set_javascript_can_access_clipboard() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen]2023.3 


Property 


WebKit2Settingst javascript-can-open-windows-automatically 


unstable since: 4.1 


Declaration 


property javascript-—can-open-windows-automatically: gboolean [ read, write, construct ] 


Description 


Whether JavaScript can open popup windows automatically without user intervention. 


Type: gboolean 


Available since: 4.1 


Default 
w BALSE 

value 

Getter : - : : : ———— 
webkit_settings_get_javascript_can_open_windows_automatical 

method 

Setter ; : : ; , ———- 
webkit_settings_set_javascript_can_open_windows_automatical 

method 

Flags 

Readable yes 

Writable yes 

Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 
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Property 


WebKit2Settings:load-icons-ignoring-image-load-setting 


unstable deprecated: 2.42 since: 4.1 


Declaration 


property load-icons-ignoring-image-load-setting: gboolean [ read, write, construct ] 


Description 


Unsupported setting. This property does nothing. 


Type: gboolean 
Available since: 4.1 
Deprecated since: 2.42 


Please do not use it in newly written code. 


Default FALSE 

value 

Getter : : 
webkit_settings_get_load_icons_ignoring_image_load_setting() 

method 

Setter : 
webkit_settings_set_load_icons_ignoring_image_load_setting() 

method 

Flags 

Readable yes 

Writable yes 

Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


load-icons-ignoring-image-load-settingJmedia-content-types-requiring-hardware-support 


Generated by[gi-docgen]2023.3 


Property 


WebKit2Settings:media-content-types-requiring-hardware-support 


since: 2.30 


Declaration 


property media-content-types-—requiring-hardware-support: utf8 [ read, write, construct ] 


Description 


List of media content types requiring hardware support, split by semicolons (:). For example: 
“video/webm; codecs=’’vp “:video/mp4; codecs=”avc*:video/&ast; codecs="av1*’”’. 


Type: gchar* 
Available since: 2.30 


Default 


NULL 

value 

Getter - - : — 

1 ihead webkit_settings_get_media_content_types_requiring_hardware_support () 
Setter - - : — 

aiethiod webkit_settings_set_media_content_types_requiring_hardware_support () 
Flags 

Readable yes 

Writable yes 

Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:media-playback-allows-inline 


unstable since: 4.1 


Declaration 


property media-playback-allows-inline: gboolean [ read, write, construct ] 


Description 


Whether media playback is full-screen only or inline playback is allowed. This is TRUE by default, so 


media playback can be inline. Setting it to FALSE allows specifying that media playback should be 
always fullscreen. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_settings_get_media_playback_allows_inline() 


Setter method webkit_settings_set_media_playback_allows_inline() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstmedia-playback-requires-user-gesture 


unstable since: 4.1 


Declaration 


property media-playback-requires-user-gesture: gboolean [ read, write, construct ] 


Description 


Whether a user gesture (such as clicking the play button) would be required to start media playback or 
load media. This is off by default, so media playback could start automatically. Setting it on requires a 
gesture by the user to start playback, or to load the media. 


Type: gboolean 


Available since: 4.1 


Default FALSE 

value 

Getter ; ; : 
webkit_settings_get_media_playback_requires_user_gesture() 

method 

Setter - : 
webkit_settings_set_media_playback_requires_user_gesture() 

method 

Flags 

Readable yes 

Writable yes 

Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:minimum-font-size 


unstable since: 4.1 


Declaration 


property minimum-font-size: guint [ read, write, construct ] 


Description 


The minimum font size in pixels used to display text. This setting controls the absolute smallest size. 
Values other than 0 can potentially break page layouts. 


Type: guint 


Available since: 4.1 


Default value 0 


Getter method |webkit_settings_get_minimum_font_size() 


Setter method webkit_settings_set_minimum_font_size() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:monospace-font-family 


unstable since: 4.1 


Declaration 


property monospace-font-family: utf8 [ read, write, construct ] 


Description 


The font family used as the default for content using a monospace font. 


Type: gchar* 


Available since: 4.1 


Default value monospace 


Getter method |webkit_settings_get_monospace_font_family () 


Setter method webkit_settings_set_monospace_font_family () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings: pictograph-font-family 


unstable since: 4.1 


Declaration 


property pictograph-font-family: utf8 [ read, write, construct ] 


Description 


The font family used as the default for content using a pictograph font. 


Type: 


Available since: 


Default value 
Getter method 


Setter method 


Flags 


Readable 
Writable 
Construct 


Construct only 


gchar* 


4.1 


serif 


webkit_settings_get_pictograph_font_+s 


webkit_settings_set_pictograph_font_family () 


yes 
yes 
yes 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingst print-backgrounds 


unstable since: 4.1 


Declaration 


property print-backgrounds: gboolean [ read, write, construct ] 


Description 


Whether background images should be drawn during printing. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_settings_get_print_backgrounds () 
Setter method webkit_settings_set_print_backgrounds () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settingstsans-serif-font-family 


unstable since: 4.1 


Declaration 


property sans-serif-font-family: utf8 [ read, write, construct ] 


Description 


The font family used as the default for content using a sans-serif font. 
Type: gchar* 


Available since: 4.1 


Default value sans-serif 


Getter method |webkit_settings_get_sans_serif_font_family() 


Setter method |webkit_settings_set_sans_serif_font_family() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings:serif-font-family 


unstable since: 4.1 


Declaration 


property serif-font-family: utf8 [ read, write, construct ] 


Description 


The font family used as the default for content using a serif font. 


Type: gchar* 


Available since: 4.1 


Default value serif 


Getter method |webkit_settings_get_serif_font_family () 


Setter method webkit_settings_set_serif_font_family () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings-user-agent 


unstable since: 4.1 


Declaration 


property user-agent: utf8 [ read, write, construct ] 


Description 


The user-agent string used by WebKit. Unusual user-agent strings may cause web content to render 
incorrectly or fail to run, as many web pages are written to parse the user-agent strings of only the most 
popular browsers. Therefore, it’s typically better to not completely override the standard user-agent, but to 
use webkit_settings_set_user_agent_with_application_details () instead. 


If this property is set to the empty string or NULL, it will revert to the standard user-agent. 


Type: gchar* 


Available since: 4.1 


Default value NULL 
Getter method |webkit_settings_get_user_agent () 


Setter method webkit_settings_set_user_agent () 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


image- load- setting media- content: types-requiring -hardware- sup port 


Generated by[gi-docgen|2023.3 


Property 


WebKit2Settings;z00m-text-only 


unstable since: 4.1 


Declaration 


property zoom-text-only: gboolean [ read, write, construct ] 


Description 


Whether WebKitWebView: zoom-level affects only the text of the page or all the contents. Other 
contents containing text like form controls will be also affected by zoom factor when this property 
is enabled. 


Type: gboolean 


Available since: 4.1 


Default value FALSE 


Getter method |webkit_settings_get_zoom_text_only() 


Setter method webkit_settings_set_zoom_text_only() 


Flags 
Readable yes 
Writable yes 
Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
URIRequest 


Constructors 


new 


Instance methods 


get_http_headers|get_http_method 


Properties 

uri 

Generated by|gi-docgen]2023.3 
Class 


WebKit2U RI Request 


unstable since: 4.1 


Description 


class WebKit2.URIRequest : GObject.Object 
{ 

priv: WebKitURIRequestPrivate* 
} 


Represents a URI request. 


A WebKitURIRequest can be created with a URI using the webkit_uri_request_new () 
method, and you can get the URI of an existing request with the webkit_uri_request_get_uri () 
one. 


Available since: 4.1 


Hierarchy 
hierarchy this WebKitURIRequest ancestor_0 GObject ancestor_O--this 


Ancestors 
@ GObject 


Constructors 
webkit_uri_request_new 
Creates anew WebKit URIRequest for the given URI. 


unstable since: 4.1 


Instance methods 


Get the HTTP headers of a WebKitURIRequest as a SoupMessageHeaders. 


unstable since: 4.1 


webkit_uri_request_get_http_method 


Get the HTTP method of the WebKitURIRequest. 


since: 2.12 


Obtains the request URI. 

unstable since: 4.1 

Set the URI of request. 

unstable since: 4.1 

Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.URIRequest:uri 


The URI to which the request will be made. 


unstable since: 4.1 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2URIRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 


void (* _webkit_reserved2) ( 


void (* _webkit_reserved3) ( 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 


_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 


Content 


Description 
Hierarch 


Constructors 
ethods 
roperties 


eeeeee 
as) 

alclz 
Q 
ig’) 
a 
ie} 
a 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
URIRequest 


Constructors 


new 
Generated by[gi-docgen|2023.3 


Constructor 


WebKit2ZURIRequestnew 
Declaration 


WebKitURIRequest* 
webkit_uri_request_new ( 
const gchar* uri 


) 


Description 


Creates anew WebKitURIRequest for the given URI. 
Parameters 
uri 

Type: const gchar* 

An URI. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitURIRequest 


A new WebKitURIRequest. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


Generated by[gi-docgen|2023.3 


Method 


WebKit J RIRequestget_http_headers 
Declaration 


SoupMessageHeaders* 

webkit_uri_request_get_http_headers ( 
WebKitURIRequest* request 

) 


Description 


Get the HTTP headers of aWebKitURIRequest as a SoupMessageHeaders. 


Return value 
Type: SoupMessageHeaders 


A SoupMessageHeaders with the HTTP headers of request or NULL if request is not an 
HTTP request. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 
WebKit2URIRequestget_http_method 
since: 2.12 


Declaration 


const gchar* 

webkit_uri_request_get_http_method ( 
WebKitURIRequest* request 

) 


Description 


Get the HTTP method of the WebKitURIRequest. 
Available since: 2.12 

Return value 

Type: const gchar* 


The HTTP method of the WebKitURIRequest or NULL if request is not an HTTP request. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 


WebKit2ZURIRequestget_uri 
Declaration 


const gchar* 
webkit_uri_request_get_uri ( 

WebKitURIRequest* request 
) 


Description 


Obtains the request URI. 


Gets property |WebKit2.URIRequest:uri 


Return value 
Type: const gchar* 
Request URI, as a string. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 


WebKit2URIRequestset_uri 
Declaration 


void 


webkit_uri_request_set_uri ( 
WebKitURIRequest* request, 
const gchar* uri 


) 


Description 


Set the URI of request. 


Sets property |WebKit2.URIRequest:uri 


Parameters 
url 
Type: const gchar* 


An URI. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
URIRequest 


Properties 


uri 
Generated by[gi-docgen|2023.3 
Property 


WebKitZURIRequestruri 


unstable since: 4.1 


Declaration 


property uri: utf8 [ read, write, construct ] 


Description 


The URI to which the request will be made. 


Type: gchar* 


Available since: 4.1 


Default value about:blank 


Getter method |webkit_uri_request_get_uri() 


Setter method webkit_uri_request_set_uri() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
yes 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
URIResponse 


Instance methods 


get_content_length]get_http_headers get_status_codelget_suggested_filename 
Properties 


content-length]http-headers suggested-filename 
Generated by 2023.3 


Class 


WebKit2U RIResponse 


unstable since: 4.1 


Description 


class WebKit2.URIResponse : GObject.Object 


{ 
priv: WebKitURIResponsePrivate* 


} 


Represents an URI response. 


A WebKitURIResponse contains information such as the URI, the status code, the content length, the 
mime type, the HTTP status or the suggested filename. 


Available since: 4.1 


Hierarchy 
hierarchy this WebKitURIResponse ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 


webkit_uri_response_get_content_length 


Get the expected content length of the WebKit URIResponse. 

unstable since: 4.1 

[webkit_uri_response_get_http_headers] 

Get the HTTP headers of a WebKitURIResponse as a SoupMessageHeaders. 
since: 2.6 

Gets the MIME type of the response. 

unstable since: 4.1 

Get the status code of the WebKitURIResponse. 


unstable since: 4.1 


webkit_uri_response_get_suggested_filename 


Get the suggested filename for response. 

unstable since: 4.1 

Gets the URI which resulted in the response. 
unstable since: 4.1 

Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.URIResponse:content-length 


The expected content length of the response. 


unstable since: 4.1 


WebKit2.URIResponse:http-headers 


The HTTP headers of the response, or NULL if the response is not an HTTP response. 


since: 2.6 

The MIME type of the response. 

unstable since: 4.1 

WebKit2.URIResponse:status-code 

The status code of the response as returned by the server. 
unstable since: 4.1 

The suggested filename for the URI response. 

unstable since: 4.1 

The URI for which the response was made. 


unstable since: 4.1 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 


g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2URIResponseClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
\e 
void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void ( 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

URIResponse 

Methods 

get_content_length]get_http_headers get_status_codelget_suggested_filename 


Generated by[gi-docgen]2023.3 
Method 


WebKit J RIResponseget_content_length 
Declaration 


guint64 

webkit_uri_response_get_content_length ( 
WebKitURIResponse* response 

) 


Description 


Get the expected content length of the WebKitURIResponse. 


It can be 0 if the server provided an incorrect or missing Content-Length. 


Gets property |WebKit2.URIResponse:content-—length 


Return value 
Type: guint 64 


The expected content length of response. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

URIResponse 

Methods 

get_content_length]get_http_headers get_status_codelget_suggested_filename 
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Method 
WebKit J RIResponseget_http_headers 
since: 2.6 


Declaration 


SoupMessageHeaders* 
webkit_uri_response_get_http_headers ( 
WebKitURIResponse* response 


) 


Description|[src] 
Get the HTTP headers of a WebKitURIResponse as a SoupMessageHeaders. 


Available since: 2.6 


Gets property |WebKit2.URIResponse:http—headers 


Return value 
Type: SoupMessageHeaders 


A SoupMessageHeaders with the HTTP headers of response or NULL if response is not an 
HTTP response. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


get_content_length]get_http_headers get_status_codelget_suggested_filename 
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Method 


WebKit2URIResponseget_mime_type 
Declaration 


const gchar* 

webkit_uri_response_get_mime_type ( 
WebKitURIResponse* response 

) 


Description 


Gets the MIME type of the response. 


Gets property |WebKit2.URIResponse:mime-type 


Return value 
Type: const gchar* 
MIME type, as a string. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

URIResponse 

Methods 

get_content_length]get_http_headers get_status_codelget_suggested_filename 
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Method 


WebKit J RIResponseget_status_code 
Declaration 


guint 

webkit_uri_response_get_status_code ( 
WebKitURIResponse* response 

) 


Description 


Get the status code of the WebKitURIResponse. 


Get the status code of the WebKit URIResponse as returned by the server. It will normally be a 
SoupKnownStatusCode, for example SOUP_STATUS_OK, though the server can respond with any 
unsigned integer. 


Gets property |WebKit2.URIResponse:status—code 


Return value 
Type: guint 


The status code of response. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

URIResponse 

Methods 

get_content_length]get_http_headers get_status_codelget_suggested_filename 
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Method 


WebKit21URIResponseget_suggested_filename 
Declaration 


const gchar* 

webkit_uri_response_get_suggested_filename ( 
WebKitURIResponse* response 

) 


Description 


Get the suggested filename for response. 


Get the suggested filename for response, as specified by the ‘Content-Disposition’ HTTP header, or 
NULL if it’s not present. 


Gets property |WebKit2.URIResponse: suggested—-filename 


Return value 
Type: const gchar* 


The suggested filename or NULL if the “Content-Disposition’ HTTP header is not present. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

URIResponse 

Methods 

get_content_length]get_http_headers get_status_codelget_suggested_filename 
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Method 


WebKit2URIResponseget_uri 
Declaration 


const gchar* 
webkit_uri_response_get_uri ( 

WebKitURIResponse* response 
) 


Description 


Gets the URI which resulted in the response. 


Gets property |WebKit2.URIResponse:uri 


Return value 
Type: const gchar* 
Response URI, as a string. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
URIResponse 


Properties 


content-length]http-headers suggested-filename 
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Property 


WebKit21URIResponsetcontent-length 


unstable since: 4.1 


Declaration 


property content-length: guint64 [ read ] 


Description 


The expected content length of the response. 


Type: guint 64 


Available since: 4.1 


Default value 0 


Getter method |webkit_uri_response_get_content_length () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
URIResponse 


Properties 


content-length]http-headers suggested-filename 
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Property 


WebKit21URIResponsethttp-headers 


since: 2.6 


Declaration 


property http-headers: Soup.MessageHeaders [ read ] 


Description 


The HTTP headers of the response, or NULL if the response is not an HTTP response. 


Type: SoupMessageHeaders 


Available since: 2.6 


Getter method |webkit_uri_response_get_http_headers () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
URIResponse 


Properties 


content-length]http-headers suggested-filename 
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Property 


WebKit21URIResponsetmime-type 


unstable since: 4.1 


Declaration 


property mime-type: utf8 [ read ] 


Description 


The MIME type of the response. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_uri_response_get_mime_type() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
URIResponse 


Properties 


content-length]http-headers suggested-filename 
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Property 


WebKit21URIResponsetstatus-code 


unstable since: 4.1 


Declaration 


property status-code: guint [ read ] 


Description 


The status code of the response as returned by the server. 


Type: guint 


Available since: 4.1 


Default value 0 


Getter method |webkit_uri_response_get_status_code() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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Library Version: 2.42.4 


Type 
URIResponse 


Properties 


content-length]http-headers suggested-filename 
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Property 


WebKit2)UR IResponsetsuggested-filename 


unstable since: 4.1 


Declaration 


property suggested-filename: utf8 [ read ] 


Description 


The suggested filename for the URI response. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_uri_response_get_suggested_filename () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
URIResponse 


Properties 


content-length]http-headers suggested-filename 
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Property 


WebKit2URIResponseturi 


unstable since: 4.1 


Declaration 


property uri: utf8 [ read ] 


Description 


The URI for which the response was made. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_uri_response_get_uri () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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Class 


WebKit2URISchemeRequest 


unstable since: 4.1 


Description 


class WebKit2.URISchemeRequest : GObject.Object 
{ 

priv: WebKitURISchemeRequestPrivate* 
} 


Represents a URI scheme request. 


If you register a particular URI scheme in a WebKitWebContext, using 
webkit_web_context_register_uri_scheme(), you have to provide a 
WebKitURISchemeRequestCallback. After that, when a URI request is made with that particular 
scheme, your callback will be called. There you will be able to access properties such as the scheme, the 
URI and path, and the WebKit WebView that initiated the request, and also finish the request 

with webkit_uri_scheme_request_finish(). 


Available since: 4.1 


Hierarchy 
hierarchy this WebKitURISchemeRequest ancestor_0 GObject ancestor_0--this 


Ancestors 
@ GObject 


Instance methods 


webkit_uri_scheme_request_finish 


Finish a WebKitURISchemeRequest by setting the contents of the request and its mime type. 


unstable since: 4.1 


webkit_uri_scheme_request_finish_error 


Finish a WebKitURISchemeRequest with a GError. 


since: 2.2 


webkit_uri_scheme_request_finish_with_response 


Finish aWebKitURISchemeRequest by returning a WebKitURISchemeResponse. 


since: 2.36 


webkit_uri_scheme_request_get_http_body 


Get the request body. 

since: 2.40 

Get the SoupMessageHeaders of the request. 
since: 2.36 

Get the HTTP method of the request. 


since: 2.36 


webkit_uri_scheme_request_get_path 


Get the URI path of request. 


unstable since: 4.1 


webkit_uri_scheme_request_get_scheme 


Get the URI scheme of request. 


unstable since: 4.1 


webkit_uri_scheme_request_get_uri 


Get the URI of request. 


unstable since: 4.1 


webkit_uri_scheme_request_get_web_view 


Get the WebKitWebView that initiated the request. 


unstable since: 4.1 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2URISchemeRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 


void (* _webkit_reserved2) ( 


void (* _webkit_reserved3) 
void 


i 
} 


No description available. 
Class members 


parent_class: 
No description available. 

_webkit_reserved0: void 
No description available. 

_webkit_reservedl: void 
No description available. 

_webkit_reserved2: void 
No description available. 

_webkit_reserved3: void 
No description available. 
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Method 


WebKit2URISchemeRequestfinish 
Declaration 


void 
webkit_uri_scheme_request_finish ( 
WebKitURISchemeRequest* request, 
GInputStream* stream, 
gint64 stream_length, 
const gchar* content_type 
) 


Description 
Finish aWebKitURISchemeRequest by setting the contents of the request and its mime type. 
Parameters 
stream 
Type: GInputStream 


A GInput Stream to read the contents of the request. 


The data is owned by the caller of the method. 


stream_length 
Type: gint 64 


The length of the stream or -1 if not known. 


content_type 
Type: const gchar* 
The content type of the stream or NULL if not known. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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finish_with_response|get_http_body|get_http_headers|get_http_method 
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Method 


WebKit2URISchemeRequestfinish_error 


since: 2.2 


Declaration 


void 

webkit_uri_scheme_request_finish_error ( 
WebKitURISchemeRequest* request, 
GError* error 


) 


Description 


Finish a WebKitURISchemeRequest with a GError. 
Available since: 2.2 

Parameters 

error 


Type: GError 


A GError that will be passed to the WebKitWebView. 


The data is owned by the caller of the method. 
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Method 


WebKit | RISchemeRequestfinish_with_response 


since: 2.36 


Declaration 


void 

webkit_uri_scheme_request_finish_with_response ( 
WebKitURISchemeRequest* request, 
WebKitURISchemeResponse* response 


) 


Description 


Finish a WebKitURISchemeRequest by returning a WebKitURISchemeResponse. 


Available since: 2.36 


Parameters 


response 


Type:|WebKitURISchemeResponse 


A WebKitURISchemeResponse. 


The data is owned by the caller of the method. 
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Methods 
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Method 


WebKit2URISchemeRequestget_http_body 


since: 2.40 


Declaration 


GInputStream* 
webkit_uri_scheme_request_get_http_body ( 
WebKitURISchemeRequest* request 


) 


Description 


Get the request body. 


Available since: 2.40 


Return value 
Type: GInput Stream 


(nullable): the body of the request. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 
WebKit | RISchemeRequestget_http_headers 
since: 2.36 


Declaration 


SoupMessageHeaders* 

webkit_uri_scheme_request_get_http_headers ( 
WebKitURISchemeRequest* request 

) 


Description 


Get the SoupMessageHeaders of the request. 


Available since: 2.36 


Return value 
Type: SoupMessageHeaders 


The SoupMessageHeaders of the request. 


The data is owned by the instance. 
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Method 
WebKit | RISchemeRequestget_http_method 
since: 2.36 


Declaration 


const gchar* 
webkit_uri_scheme_request_get_http_method ( 
WebKitURISchemeRequest* request 


) 


Description 


Get the HTTP method of the request. 
Available since: 2.36 

Return value 

Type: const gchar* 


The HTTP method of the request. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKitZURISchemeRequestget_path 
Declaration 


const gchar* 

webkit_uri_scheme_request_get_path ( 
WebKitURISchemeRequest* request 

) 


Description 


Get the URI path of request. 
Return value 

Type: const gchar* 

The URI path of request. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit J RISchemeRequestget_scheme 
Declaration 


const gchar* 

webkit_uri_scheme_request_get_scheme ( 
WebKitURISchemeRequest* request 

) 


Description 


Get the URI scheme of request. 
Return value 

Type: const gchar* 

The URI scheme of request. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2URISchemeRequestget_uri 
Declaration 


const gchar* 

webkit_uri_scheme_request_get_uri ( 
WebKitURISchemeRequest* request 

) 


Description 


Get the URI of request. 
Return value 

Type: const gchar* 
The full URI of request. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit J RISchemeRequestget_web_view 
Declaration 


WebKitWebView* 

webkit_uri_scheme_request_get_web_view ( 
WebKitURISchemeRequest* request 

) 


Description 


Get the WebKitWebView that initiated the request. 


Return value 


Type: 


The WebKitWebView that initiated request. 


The data is owned by the instance. 
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Class 


WebKit2URISchemeResponse 


unstable since: 4.1 


Description 


class WebKit2.URISchemeResponse : GObject.Object 
{ 

priv: WebKitURISchemeResponsePrivate* 
} 


Represents a URI scheme response. 


If you register a particular URI scheme in a WebKitWebContext, using 
webkit_web_context_register_uri_scheme(), you have to provide a 
WebKitURISchemeRequestCallback. After that, when a URI response is made with that particular 
scheme, your callback will be called. There you will be able to provide more response parameters when 
the methods and properties of aWebKitURISchemeRequest is not enough. 


When you finished setting up yourWebKit URISchemeResponse, call 
webkit_uri_request_finish_with_response() with it to return the response. 


Available since: 4.1 


Hierarchy 
hierarchy this WebKitURISchemeResponse ancestor_0 GObject ancestor_0--this 


Ancestors 
@ GObject 


Constructors 


webkit_uri_scheme_response_new 


Create anew WebKitURISchemeResponse. 


since: 2.36 


Instance methods 


webkit_uri_scheme_response_set_content_type 


Sets the content type for the response. 

since: 2.36 

Assign the provided SoupMessageHeaders to the response. 
since: 2.36 

webkit_uri_scheme_response_set_status 

Sets the status code and reason phrase for the response. 
since: 2.36 


Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2. URISchemeResponse:stream 


The input stream to read from. 


since: 2.36 


WebKit2. URISchemeResponse:stream-length 


The input stream length in bytes, -1 for unknown length. 


since: 2.36 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2URISchemeResponseClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 


void (* _webkit_reserved2) ( 


void (* _webkit_reserved3) ( 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 


_webkit_reserved0: void 
No description available. 
_webkit_reservedl: void 
No description available. 
_webkit_reserved2: void 
No description available. 
_webkit_reserved3: void 
No description available. 
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Constructor 
WebKit2URISchemeResponsenew 
since: 2.36 


Declaration 


WebKitURISchemeResponse* 
webkit_uri_scheme_response_new ( 
GInputStream* input_stream, 
gint64 stream_length 

) 


Description 


Create anew WebKitURISchemeResponse. 
Available since: 2.36 
Parameters 
input_stream 
Type: GInputStream 


A GInput Stream to read the contents of the request. 


The data is owned by the caller of the function. 


stream_length 
Type: gint 64 


The length of the stream or -1 if not known. 


Return value 


Type: |WebKitURISchemeResponse 


The newly created WebKitURISchemeResponse. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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URISchemeResponse 


Methods 
set_content_typelset_http_headers 
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Method 


WebKit2URISchemeResponseset_content_type 


since: 2.36 


Declaration 


void 
webkit_uri_scheme_response_set_content_type ( 
WebKitURISchemeResponse* response, 
const gchar* content_type 


) 


Description 


Sets the content type for the response. 
Available since: 2.36 
Parameters 
content_type 
Type: const gchar* 


The content type of the stream. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Methods 
set_content_typelset_http_headers 
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Method 


WebKit J RISchemeResponseset_http_headers 


since: 2.36 


Declaration 


void 

webkit_uri_scheme_response_set_http_headers ( 
WebKitURISchemeResponse* response, 
SoupMessageHeaders* headers 


) 


Description 


Assign the provided SoupMessageHeaders to the response. 


headers need to be of the type SOUP_MESSAGE_HEADERS_RESPONSE. Any existing headers will 
be overwritten. 


Available since: 2.36 


Parameters 


headers 


Type: SoupMessageHeaders 


The HTTP headers to be set. 


The instance takes ownership of the data, and is responsible for freeing it. 
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Type 
URISchemeResponse 


Methods 
set_content_typelset_http_headers 
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Method 


WebKit J RISchemeResponseset_status 


since: 2.36 


Declaration 


void 
webkit_uri_scheme_response_set_status ( 
WebKitURISchemeResponse* response, 
guint status_code, 
const gchar* reason_phrase 


) 


Description 


Sets the status code and reason phrase for the response. 


If status_code is a known value and reason_phrase is NULL, the reason_phrase will be 
set automatically. 


Available since: 2.36 


Parameters 


status_code 


Type: guint 


The HTTP status code to be returned. 


reason_phrase 
Type: const gchar* 
A reason phrase. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Property 
WebKit2URISchemeResponsetstream 
since: 2.36 

Declaration 


property stream: Gio.InputStream [ write, construct-only ] 


Description 


The input stream to read from. 


Type: GInputStream 


Available since: 2.36 


Flags 
Readable no 
Writable yes 
Construct no 


Construct only yes 
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Property 


WebKit2URISchemeResponsetstream-length 


since: 2.36 


Declaration 


property stream-length: gint64 [ write, construct-only ] 


Description 


The input stream length in bytes, -1 for unknown length. 


Type: gint64 
Available since: 2.36 


Default value _ -1 


Flags 


Readable 
Writable 
Construct 


Construct only 


no 
yes 
no 


yes 
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Class 


WebKit2\UserContentFilterStore 


since: 2.24 


Description 


class WebKit2.UserContentFilterStore : GObject.Object 
{ 

priv: WebKitUserContentFilterStorePrivate* 
} 


Handles storage of user content filters on disk. 


The WebKitUserContentFilterStore provides the means to import and save[JSON rule sets} which can be 
loaded later in an efficient manner. Once filters are stored, the WebKitUserContentFilter objects 
which represent them can be added to a WebKitUserContentManager 

with webkit_user_content_manager_add_filter(). 


JSON rule sets are imported using webkit_user_content_filter_store_save() and stored 
on disk in an implementation defined format. The contents of a filter store must be managed using the 
WebKitUserContentFilterStore: a list of all the stored filters can be obtained with 
webkit_user_content_filter_store_fetch_identifiers(), 
webkit_user_content_filter_store_load() can be used to retrieve a previously saved filter, 
and removed from the store with webkit_user_content_filter_store_remove(). 


Available since: 2.24 


Hierarchy 


hierarchy this WebKitUserContentFilterStore ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Constructors 


webkit_user_content_filter_store_new 


Create anew WebKitUserContentFilterStore to manipulate filters stored at storage_path. 


since: 2.24 


Instance methods 


webkit_user_content_filter_store_fetch_identifiers 


Asynchronously retrieve a list of the identifiers for all the stored filters. 


since: 2.24 


webkit_user_content_filter_store_fetch_identifiers_finish 


Finishes an asynchronous fetch of the list of stored filters. 
since: 2.24 
Gets the storage path for user content filters. 


since: 2.24 


webkit_user_content_filter_store_load 


Asynchronously load a content filter given its identifier. 


since: 2.24 


webkit_user_content_filter_store_load_finish 


Finishes an asynchronous filter load previously started with webkit_user_content_filter_store_load(). 


since: 2.24 


webkit_user_content_filter_store_remove 


Asynchronously remove a content filter given its identifier. 


since: 2.24 


webkit_user_content_filter_store_remove_finish 


Finishes an asynchronous filter removal previously started 
with webkit_user_content_filter_store_remove(). 


since: 2.24 


webkit_user_content_filter_store_save 


Asynchronously save a content filter from a set source rule. 


since: 2.24 


webkit_user_content_filter_store_save_finish 


Finishes an asynchronous filter save previously started with webkit_user_content_filter_store_save(). 


since: 2.24 
webkit_user_content_filter_store_save_from_file 


Asynchronously save a content filter from the contents of a file. 


since: 2.24 


webkit_user_content_filter_store_save_from_file_finish 


Finishes and asynchronous filter save previously started 
with webkit_user_content_filter_store_save_from_file(). 


since: 2.24 
Methods inherited from GObject (43) 
Please see GObject for a full list of methods. 


Properties 


WebKit2.UserContentFilterStore:path 


The directory used for filter storage. This path is used as the base directory where user content filters are 
stored on disk. 


since: 2.24 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2UserContentFilterStoreClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 


void (* _webkit_reservedl) ( 


void (* _webkit_reserved2) ( 


void (* _webkit_reserved3) ( 
void 

i 
} 


No description available. 


Class members 


parent_class: 
No description available. 

_webkit_reserved0: void 
No description available. 

_webkit_reservedl: void 
No description available. 

_webkit_reserved2: void 
No description available. 

_webkit_reserved3: void 
No description available. 


Content 


Description 
Hierarch 


onstructors 
ethods 
roperties 


a=] | | [| 
=) 
Qa 
ig) 
a 
ie} 
B 


GObjectClass 


(* 


(* 


(* 


(* 


_webkit_reserved0) 


_webkit_reservedl1) 


_webkit_reserved2) 


_webkit_reserved3) 


void 


void 


void 


void 


) 


) 


) 


) 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
UserContentFilterStore 


Constructors 


new 


Generated by[gi-docgen|2023.3 


Constructor 
WebKit2UserContentFilterStorenew 
since: 2.24 


Declaration 


WebKitUserContentFilterStore* 
webkit_user_content_filter_store_new ( 
const gchar* storage_path 


) 


Description |[src] 
Create anew WebKitUserContentFilterStore to manipulate filters stored at storage_path. 


The path must point to a local filesystem, and will be created if needed. 


Available since: 2.24 


Parameters 
storage_path 


Type: const gchar* 


Path where data for filters will be stored on disk. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitUserContentFilterStore 


A newly created WebKitUserContentFilterStore. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2UserContentFilterStorefetch_identifiers 


since: 2.24 


Declaration 


void 
webkit_user_content_filter_store_fetch_identifiers ( 
WebKitUserContentFilterStore* store, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously retrieve a list of the identifiers for all the stored filters. 


When the operation is finished, callback will be invoked, which then can use 
webkit_user_content_filter_store_fetch_identifiers_finish() to obtain the list 
of filter identifiers. 


Available since: 2.24 


Parameters 
cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the removal is completed. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to the callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2UserContentFilterStorefetch_identifiers_finish 


since: 2.24 


Declaration 


gchar** 
webkit_user_content_filter_store_fetch_identifiers_finish ( 
WebKitUserContentFilterStore* store, 
GAsyncResult* result 
) 


Description 


Finishes an asynchronous fetch of the list of stored filters. 


Finishes an asynchronous fetch of the list of identifiers for the stored filters previously started 
with webkit_user_content_filter_store_fetch_identifiers(). 


Available since: 2.24 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


Return value 

Type: An array of ut £8 

A NULL-terminated list of filter identifiers. 
The array is NULL-terminated. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


Each element is a NUL terminated UTF-8 string. 
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Method 
WebKit2UserContentFilterStoreget_path 
since: 2.24 


Declaration 


const gchar* 
webkit_user_content_filter_store_get_path ( 
WebKitUserContentFilterStore* store 


) 


Description 


Gets the storage path for user content filters. 


Available since: 2.24 


Gets property |WebKit2.UserContentFilterStore:path 


Return value 


Type: const gchar* 


Path, as a string. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2UserContentFilterStoreload 


since: 2.24 


Declaration 


void 

webkit_user_content_filter_store_load ( 
WebKitUserContentFilterStore* store, 
const gchar* identifier, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


) 


Description 


Asynchronously load a content filter given its identifier. 


The filter must have been previously stored using webkit_user_content_filter_store_save(). 


When the operation is finished, callback will be invoked, which then can use 
webkit_user_content_filter_store_load_finish () to obtain the resulting filter. 


Available since: 2.24 


Parameters 
identifier 
Type: const gchar* 
A filter identifier. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the load is completed. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to the callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 
WebKit2UserContentFilterStoreload_finish 
since: 2.24 


Declaration 


WebKitUserContentFilter* 
webkit_user_content_filter_store_load_finish ( 
WebKitUserContentFilterStore* store, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finishes an asynchronous filter load previously started with webkit_user_content_filter_store_load(). 


Available since: 2.24 


Parameters 
result 


Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 


Type: |WebKitUserContentFilter 


A WebKitUserContentFilter, or NULL if the load failed. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 
WebKit2UserContentFilterStoreremove 
since: 2.24 


Declaration 


void 
webkit_user_content_filter_store_remove ( 
WebKitUserContentFilterStore* store, 
const gchar* identifier, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


) 


Description 


Asynchronously remove a content filter given its identifier. 


When the operation is finished, callback will be invoked, which then can use 
webkit_user_content_filter_store_remove_finish() to check whether the removal 
was successful. 


Available since: 2.24 


Parameters 
identifier 
Type: const gchar* 
A filter identifier. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the removal is completed. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to the callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2UserContentFilterStoreremove_finish 


since: 2.24 


Declaration 


gboolean 
webkit_user_content_filter_store_remove_finish ( 
WebKitUserContentFilterStore* store, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finishes an asynchronous filter removal previously started 
with webkit_user_content_filter_store_remove(). 


Available since: 2.24 


Parameters 


result 


Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for{a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 

Return value 

Type: gboolean 


Whether the removal was successful. 
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Method 


WebKit2UserContentFilterStoresave 


since: 2.24 


Declaration 


void 


webkit_user_content_filter_store_save ( 
WebKitUserContentFilterStore* store, 
const gchar* identifier, 


GBytes* source, 

GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously save a content filter from a set source rule. 


Asynchronously save a content filter from a source rule set in the|WebKit content extesions JSON format 


The identifier can be used afterwards to refer to the filter when using 
webkit_user_content_filter_store_remove() and 
webkit_user_content_filter_store_load(). When the identifier has been used in the past, the new filter 
source will replace the one saved beforehand for the same identifier. 


When the operation is finished, callback will be invoked, which then can use 
webkit_user_content_filter_store_save_finish () to obtain the resulting filter. 


Available since: 2.24 
Parameters 
identifier 

Type: const gchar* 


A string used to identify the saved filter. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


source 
Type: GBytes 
GBytes containing the rule set in JSON format. 


The data is owned by the caller of the method. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 
The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when saving is completed. 


The argument can be NULL. 


user_data 


Type: gpointer 


The data to pass to the callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Methods 


fetch_identifiers|fetch_identifiers_finish load_finish 
save_from_file_finish 


Generated by[gi-docgen|2023.3 


Method 
WebKit2UserContentFilterStoresave_finish 
since: 2.24 


Declaration 


WebKitUserContentFilter* 
webkit_user_content_filter_store_save_finish ( 
WebKitUserContentFilterStore* store, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finishes an asynchronous filter save previously started with webkit_user_content_filter_store_save(). 


Available since: 2.24 


Parameters 
result 


Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 


Type: |WebKitUserContentFilter 


A WebKitUserContentFilter, or NULL if saving failed. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2UserContentFilterStoresave_from_file 


since: 2.24 


Declaration 


void 


webkit_user_content_filter_store_save_from_file ( 
WebKitUserContentFilterStore* store, 
const gchar* identifier, 
GFile* file, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously save a content filter from the contents of a file. 


Asynchronously save a content filter from the contents of a file, which must be native to the platform, as 
checked by g_file_is_native(). See webkit_user_content_filter_store_save() for 
more details. 


When the operation is finished, callback will be invoked, which then can use 
webkit_user_content_filter_store_save_finish () to obtain the resulting filter. 


Available since: 2.24 
Parameters 
identifier 

Type: const gchar* 


A string used to identify the saved filter. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


frie 
Type: GFile 
A GF ile containing the rule set in JSON format. 


The data is owned by the caller of the method. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when saving is completed. 


The argument can be NULL. 


user_data 


Type: gpointer 


The data to pass to the callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 
WebKit2UserContentFilterStoresave_from_file_finish 
since: 2.24 


Declaration 


WebKitUserContentFilter* 
webkit_user_content_filter_store_save_from_file_finish ( 
WebKitUserContentFilterStore* store, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finishes and asynchronous filter save previously started 
with webkit_user_content_filter_store_save_from_file(). 


Available since: 2.24 


Parameters 


result 


Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for{a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 


Type: |WebKitUserContentFilter 


A WebKitUserContentFilter, or NULL if saving failed. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Property 


WebKit2UserContentFilterStore: path 


since: 2.24 


Declaration 


property path: utf8 [ read, write, construct-only ] 


Description 


The directory used for filter storage. This path is used as the base directory where user content filters are 
stored on disk. 


Type: gchar* 
Available since: 2.24 


Default value NULL 


Getter method |webkit_user_content_filter_store_get_path() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 
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Class 


W ebKit2)UserContentManager 


since: 2.6 


Description 


class WebKit2.UserContentManager : GObject.Object 
{ 


priv: WebKitUserContentManagerPrivate* 


} 
Manages user-defined content which affects web pages. 


Using a WebKitUserContentManager user CSS style sheets can be set to be injected in the web 
pages loaded by a WebKitWebView, by webkit_user_content_manager_add_style_sheet(). 


To use aWebKitUserContentManager, it must be created using 
webkit_user_content_manager_new(), and then used to construct a WebKitWebView. User style sheets 
can be created with webkit_user_style_sheet_new(). 


User style sheets can be added and removed at any time, but they will affect the web pages 
loaded afterwards. 


Available since: 2.6 


Hierarchy 


hierarchy this WebKitUserContentManager ancestor_0 GObject ancestor_0--this 
Ancestors 
@ GObject 


Constructors 


webkit_user_content_manager_new 


Creates a new user content manager. 


since: 2.6 


Instance methods 


webkit_user_content_manager_add_filter 


Adds a WebKitUserContentFilter to the given WebKitUserContentManager. 


since: 2.24 


webkit_user_content_manager_add_script 


Adds a WebKitUserScript to the given WebKitUserContentManager. 


since: 2.6 


webkit_user_content_manager_add_style_sheet 


Adds a WebKitUserStyleSheet to the given WebKitUserContentManager. 


since: 2.6 


webkit_user_content_manager_register_script_message_handler 


Registers a new user script message handler. 


since: 2.8 


webkit_user_content_manager_register_script_message_handler_in_world 


Registers a new user script message handler in script world. 


since: 2.22 


webkit_user_content_manager_register_script_message_handler_with_reply 


Registers a new user script message handler in script world with name world_name. 
since: 2.40 

Removes all content filters from the given WebKitUserContentManager. 

since: 2.24 

Removes all user scripts from the given WebKitUserContentManager. 

since: 2.6 

Removes all user style sheets from the given WebKitUserContentManager. 
since: 2.6 

Removes a filter from the given WebKitUserContentManager. 


unstable since: 4.1 


webkit_user_content_manager_remove_filter_by_id 


Removes a filter by the given identifier. 


since: 2.26 


webkit_user_content_manager_remove_script 


Removes a WebKitUserScript from the given WebKitUserContentManager. 


since: 2.32 


webkit_user_content_manager_remove_style_sheet 


Removes a WebKitUserStyleSheet from the given WebKitUserContentManager. 


since: 2.32 


webkit_user_content_manager_unregister_script_message_handler 


Unregisters a previously registered message handler. 


since: 2.8 


webkit_user_content_manager_unregister_script_message_handler_in_world 


Unregisters a previously registered message handler in script world with name world_name. 


since: 2.22 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Signals 


WebKit2.UserContentManager::script-message-received 


This signal is emitted when JavaScript in a web view calls 
window.webkit.messageHandlers..postMessage (), after registering using 
webkit_user_content_manager_register_script_message_handler () 


since: 2.8 


WebKit2.UserContentManager::script-message-with-reply-received 


This signal is emitted when JavaScript in a web view calls 
window.webkit.messageHandlers..postMessage (), after registering using 
webkit_user_content_manager_register_script_message_handler_with_reply () 


since: 2.40 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2UserContentManagerClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Constructor 
WebKit2UserContentManagernew 
since: 2.6 


Declaration 


WebKitUserContentManager* 
webkit_user_content_manager_new ( 
void 


) 


Description 


Creates a new user content manager. 


Available since: 2.6 


Return value 


Type: |WebKitUserContentManager 


A WebKitUserContentManager. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2)UserContentManageradd_filter 


since: 2.24 


Declaration 


void 
webkit_user_content_manager_add_filter ( 


WebKitUserContentManager* manager, 
WebKitUserContentFilter* filter 
) 


Description |[src] 
Adds a WebKitUserContentFilter to the given WebKitUserContentManager. 


The same WebKitUserContentFilter can be reused with multiple 
WebKitUserContentManager instances. 


Filters need to be saved and loaded from WebKitUserContentFilterStore. 


Available since: 2.24 


Parameters 


filter 


Type:|(WebKitUserContentFilter 


A WebKitUserContentFilter. 


The data is owned by the caller of the method. 
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Method 


WebKit2UserContentManageradd_script 


since: 2.6 


Declaration 


void 
webkit_user_content_manager_add_script ( 


WebKitUserContentManager* manager, 
WebKitUserScript* script 
) 


Description |[src] 
Adds aWebKitUserScript to the given WebKitUserContentManager. 


The same WebKitUserScript can be reused with multiple WebKitUserContentManager 
instances. 


Available since: 2.6 


Parameters 


script 


Type:\WebKitUserScript 


A WebKitUserScript. 


The data is owned by the caller of the method. 
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Method 


WebKit J serContentManageradd_style_sheet 


since: 2.6 


Declaration 


void 
webkit_user_content_manager_add_style_sheet ( 


WebKitUserContentManager* manager, 
WebKitUserStyleSheet* stylesheet 
) 


Description |[src] 
Adds a WebKitUserStyleSheet to the given WebKitUserContentManager. 


The same WebKitUserStyleSheet can be reused with multiple WebKitUserContentManager 
instances. 


Available since: 2.6 


Parameters 


stylesheet 


Type:|WebKitUserStyleSheet 


A WebKitUserStyleSheet. 


The data is owned by the caller of the method. 
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Method 
WebKit2UserContentManagerregister_script_message_handler 
since: 2.8 


Declaration 


gboolean 
webkit_user_content_manager_register_script_message_handler ( 


WebKitUserContentManager* manager, 
const gchar* name 


) 


Description 


Registers a new user script message handler. 


After it is registered, scripts can use 

window.webkit .messageHandlers.<name>.postMessage (value) to send messages. 
Those messages are received by connecting handlers to the 
WebKitUserContentManager::script-—message-received signal. The handler name is used 
as the detail of the signal. To avoid race conditions between registering the handler name, and starting to 
receive the signals, it is recommended to connect to the signal before registering the handler name: 


WebKitWebView *view = webkit_web_view_new (); 
WebKitUserContentManager *manager = webkit_web_view_get_user_content_manager (); 
g_signal_connect (manager, "script-—message-received::foobar", 

G_CALLBACK (handle_script_message), NULL); 
webkit_user_content_manager_register_script_message_handler (manager, "foobar"); 


Registering a script message handler will fail if the requested name has been already registered before. 
Available since: 2.8 
Parameters 
name 
Type: const gchar* 
Name of the script message channel. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE if message handler was registered successfully, or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 
add_filter add_style_sheet 


Generated by[gi-docgen]2023.3 


Method 
WebKit2UserContentManagerregister_script_message_handler_in_world 
since: 2.22 

Declaration 


webkit_user_content_manager_register_script_message_handler_in_world ( 
WebKitUserContentManager* manager, 


const gchar* name, 
const gchar* world_name 


) 


Description 


Registers a new user script message handler in script world. 


Registers a new user script message handler in script world with name world_name. See 
webkit_user_content_manager_register_script_message_handler () for 
full description. 


Registering a script message handler will fail if the requested name has been already registered before. 


Available since: 2.22 


Parameters 
name 
Type: const gchar* 
Name of the script message channel. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


world_name 
Type: const gchar* 
The name of aWebKitScriptWorld. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE if message handler was registered successfully, or FALSE otherwise. 
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Method 

W ebKit2UserContentManagerregister_script_message_handler_with_reply 
since: 2.40 

Declaration 

gboolean 


webkit_user_content_manager_register_script_message_handler_with_reply ( 
WebKitUserContentManager* manager, 


const char* name, 
const char* world_name 


) 


Description 


Registers a new user script message handler in script world with name world_name. 


Different from webkit_user_content_manager_register_script_message_handler(), when using this 
function to register the handler, the connected signal is script-message-with-reply-received, and a reply 
provided by the user is expected. Otherwise, the user will receive a default undefined value. 


If NULL is passed as the world_name, the default world will be used. See 
webkit_user_content_manager_register_script_message_handler () for 
full description. 


Registering a script message handler will fail if the requested name has been already registered before. 


The registered handler can be unregistered by 
using webkit_user_content_manager_unregister_script_message_handler(). 


Available since: 2.40 


Parameters 
name 
Type: const char* 


Name of the script message channel wor1ld_name (nullable): the name of a 
WebKitScriptWorld. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


world_name 
Type: const char* 
No description available. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE if message handler was registered successfully, or FALSE otherwise. 
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Method 


WebKit2UserContentManagerremove_all_filters 


since: 2.24 


Declaration 


void 
webkit_user_content_manager_remove_all_filters ( 


WebKitUserContentManager* manager 


) 


Description 


Removes all content filters from the given WebKitUserContentManager. 


Available since: 2.24 
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Method 


WebKit J serContentManagerremove_all_scripts 


since: 2.6 


Declaration 


void 
webkit_user_content_manager_remove_all_scripts ( 


WebKitUserContentManager* manager 


) 


Description |[src] 
Removes all user scripts from the given WebKitUserContentManager 


See also webkit_user_content_manager_remove_script(). 


Available since: 2.6 
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Method 


WebKit J serContentManagerremove_all_style_sheets 


since: 2.6 


Declaration 


void 
webkit_user_content_manager_remove_all_style_sheets ( 


WebKitUserContentManager* manager 


) 


Description 


Removes all user style sheets from the given WebKitUserContentManager. 


Available since: 2.6 
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Method 


WebKit2UserContentManagerremove_filter 


since: 2.6 


Declaration 


void 
webkit_user_content_manager_remove_filter ( 


WebKitUserContentManager* manager, 
WebKitUserContentFilter* filter 
) 


Description 


Removes a filter from the given WebKitUserContentManager. 
Since 2.24 


Available since: 2.6 


Parameters 


filter 


Type:|(WebKitUserContentFilter 


A WebKitUserContentFilter. 


The data is owned by the caller of the method. 
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Method 
WebKit2)UserContentManagerremove_filter_by_id 
since: 2.26 


Declaration 


void 
webkit_user_content_manager_remove_filter_by_id ( 


WebKitUserContentManager* manager, 
const char* filter_id 


) 


Description 


Removes a filter by the given identifier. 


Removes a filter from the given WebKitUserContentManager given the identifier of a 
WebKitUserContentFilter as returned by webkit_user_content_filter_get_identifier(). 


Available since: 2.26 


Parameters 
filter_id 
Type: const char* 
Filter identifier. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2)UserContentManagerremove_script 


since: 2.32 


Declaration 


void 
webkit_user_content_manager_remove_script ( 


WebKitUserContentManager* manager, 
WebKitUserScript* script 
) 


Description |[src] 
Removes a WebKitUserScript from the given WebKitUserContentManager. 


See also webkit_user_content_manager_remove_all_scripts(). 


Available since: 2.32 


Parameters 


script 


Type:\WebKitUserScript 


A WebKitUserScript. 


The data is owned by the caller of the method. 
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Library Version: 2.42.4 
Type 


Methods 
add_ Cans eee style_sheet 
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Method 


WebKit J serContentManagerremove_style_sheet 


since: 2.32 


Declaration 


void 
webkit_user_content_manager_remove_style_sheet ( 


WebKitUserContentManager* manager, 
WebKitUserStyleSheet* stylesheet 
) 


Description |[src] 
Removes a WebKitUserStyleSheet from the given WebKitUserContentManager. 


See also webkit_user_content_manager_remove_all_style_sheets(). 


Available since: 2.32 


Parameters 


stylesheet 


Type:|WebKitUserStyleSheet 


A WebKitUserStyleSheet. 


The data is owned by the caller of the method. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 
add_ Cans eee style_sheet 
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Method 


WebKit2UserContentManagerunregister_script_message_handler 


since: 2.8 


Declaration 


void 
webkit_user_content_manager_unregister_script_message_handler ( 
WebKitUserContentManager* manager, 


const gchar* name 


) 


Description 
Unregisters a previously registered message handler. 


Note that this does not disconnect handlers for the 
WebKitUserContentManager: :script-—message-received signal; they will be kept 
connected, but the signal will not be emitted unless the handler name is registered again. 


See also webkit_user_content_manager_register_script_message_handler(). 


Available since: 2.8 
Parameters 
name 
Type: const gchar* 
Name of the script message channel. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 
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Method 
WebKit2|UserContentManagerunregister_script_message_handler_in_world 
since: 2.22 

Declaration 

void 


webkit_user_content_manager_unregister_script_message_handler_in_world ( 
WebKitUserContentManager* manager, 


const gchar* name, 
const gchar* world_name 


) 


Description |[src] 
Unregisters a previously registered message handler in script world with name world_name. 


Note that this does not disconnect handlers for the 
WebKitUserContentManager: :script—message-received signal; they will be kept 
connected, but the signal will not be emitted unless the handler name is registered again. 


See also webkit_user_content_manager_register_script_message_handler_in_world(). 


Available since: 2.22 


Parameters 
name 
Type: const gchar* 
Name of the script message channel. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


world_name 
Type: const gchar* 
The name of aWebKitScriptWorld. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


script-message-with-reply-received| 
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Signal 
WebKit2UserContentManagert:script-message-received 
since: 2.8 

Declaration 

void 


script_message_received ( 
WebKitUserContentManager* self, 
WebKitJavascriptResult* value, 
gpointer user_data 


) 


Description 


This signal is emitted when JavaScript in a web view calls 
window.webkit.messageHandlers..postMessage (), after registering using 
webkit_user_content_manager_register_script_message_handler () 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


The signal can be 


Available since: 2.8 


Parameters 


value 


Type:\WebKitJavascriptResult 


The value received from the JavaScript world. 


The data is owned by the caller of the function. 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


script-message-with-reply-received| 
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Signal 


WebKit2UserContentManagert :script-message-with-reply-received 


since: 2.40 


Declaration 


gboolean 

script_message_with_reply_received ( 
WebKitUserContentManager* self, 
JSCValue* value, 
WebKitScriptMessageReply* reply, 
gpointer user_data 

) 


Description 


This signal is emitted when JavaScript in a web view calls 
window.webkit.messageHandlers..postMessage (), after registering using 
webkit_user_content_manager_register_script_message_handler_with_reply () 


The given reply can be used to send a return value with 
webkit_script_message_reply_return_value() or an error message with 
webkit_script_message_reply_return_error_message(). If none of them are called, an automatic reply with 
an undefined value will be sent. 


It is possible to handle the reply asynchronously, by simply calling g_object_ref() onthe reply 
and returning TRUE. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


The signal can be 


Available since: 2.40 


Parameters 
value 
Type: TSCValue 


The value received from the JavaScript world. 


The data is owned by the caller of the function. 


reply 


Type: |WebKitScriptMessageReply 


The WebKitScriptMessageRepl]1y to send the reply to the script message. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 


| 


WebKit2 
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Library Version: 2.42.4 

Type 
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Class 


WebKit2UserMediaPermissionRequest 


since: 2.8 


Description 


class WebKit2.UserMediaPermissionRequest : GObject.Object 
implements WebKit2.PermissionRequest { 
priv: WebKitUserMediaPermissionRequestPrivate* 


} 


A permission request for accessing user’s audio/video devices. 


WebkKitUserMediaPermissionRequest represents a request for permission to decide whether WebKit 
should be allowed to access the user’s audio and video source devices when requested through the 
getUserMedia API. 


When a WebKitUserMediaPermissionRequest is not handled by the user, it is denied by default. 


Available since: 2.8 


Hierarchy 


hierarchy this WebKitUserMediaPermissionRequest implements_O|WebKitPermissionRequest 


this--implements_0 ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Implements 
: 
Instance methods 
Methods inherited from GObject (43) 
Please see GObject for a full list of methods. 


Methods inherited from|WebKitPermissionRequest| (2) 
webkit_permission_request_allow 


Allow the action which triggered this request. 
unstable since: 4.1 
Deny the action which triggered this request. 


unstable since: 4.1 


Properties 


WebKit2.UserMediaPermissionRequest:is-for-audio-device 


Whether the media device to which the permission was requested has a microphone or not. 


since: 2.8 


WebKit2.UserMediaPermissionRequest:is-for-video-device 


Whether the media device to which the permission was requested has a video capture capability or not. 
since: 2.8 
Signals 


Signals inherited from GObject (1) 


GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2UserMediaPermissionRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Property 
WebKit2UserMediaPermissionRequesttis-for-audio-device 
since: 2.8 

Declaration 

property is-for-audio-device: gboolean [ read ] 


Description 


Whether the media device to which the permission was requested has a microphone or not. 


Type: gboolean 


Available since: 2.8 
Default value FALSE 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 


| 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
UserMediaPermissionRequest 


Properties 
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Property 
WebKit2|UserMediaPermissionRequesttis-for-video-device 
since: 2.8 

Declaration 

property is-for-video-device: gboolean [ read ] 


Description 


Whether the media device to which the permission was requested has a video capture capability or not. 


Type: gboolean 


Available since: 2.8 
Default value FALSE 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 


| 
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get_fd_list 
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Class 


WebKit2UserMessage 


since: 2.28 


Description 


class WebKit2.UserMessage : GObject.InitiallyUnowned 
{ 
priv: WebKitUserMessagePrivate* 


} 
Message that can be sent between the UI process and web process extensions. 


A WebKitUserMessage is a message that can be used for the communication between the UI process and 
web process extensions. A WebKitUserMessage always has a name, and it can also include parameters 
and UNIX file descriptors. Messages can be sent from a WebKitWebContext to all web process 
extensions, from a web process extension to its corresponding WebKitWebContext, and from a 
WebKitWebView to its corresponding WebKitWebPage (and vice versa). One to one messages can be 
replied to directly with webkit_user_message_send_reply(). 


Available since: 2.28 


Hierarchy 


hierarchy this WebKitUserMessage ancestor_0 GInitiallyUnowned ancestor_0--this ancestor_1 GObject 
ancestor_1--ancestor_0 


Ancestors 


@ GlnitiallyUnowned 
@ GObject 


Constructors 


webkit_user_message_new 


Create anew WebKitUserMessage with name. 


since: 2.28 


webkit_user_message_new_with_fd_list 


Create anew WebKit UserMessage including also a list of UNIX file descriptors to be sent. 


since: 2.28 


Instance methods 

Get the message list of file descritpor. 
since: 2.28 

Get the message name. 

since: 2.28 

Get the message parameters. 


since: 2.28 


webkit_user_message_send_reply 


Send a reply to an user message. 
since: 2.28 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.UserMessage:fd-list 


The UNIX file descriptors of the user message. 


since: 2.28 


WebKit2.UserMessage:name 


The name of the user message. 


since: 2.28 


WebKit2.UserMessage:parameters 


The parameters of the user message as a GVariant, or NULL if the message doesn’t include parameters. 
Note that only complete types are allowed. 


since: 2.28 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2UserMessageClass { 
GInitiallyUnownedClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 


i 

void (* _webkit_reserved2) ( 
void 

i 

void (* _webkit_reserved3) ( 
void 


i 
} 
No description available. 


Class members 


parent_class: GInitiallyUnownedClass 
No description available. 


_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 


No description available. 
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Constructor 


WebKit2UserMessagenew 


since: 2.28 


Declaration 


WebKitUserMessage* 

webkit_user_message_new ( 
const char* name, 
GVariant* parameters 


) 


Description 


Create anew WebKitUserMessage with name. 
Available since: 2.28 
Parameters 
name 
Type: const char* 


The message name. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


parameters 
Type: GVariant 


The message parameters as a GVariant, or NULL. 


The argument can be NULL. 


The data is owned by the caller of the function. 


Return value 


Type: |WebKitUserMessage 


The newly created WebKitUserMessage object. 


The data is owned by the called function. 
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Constructor 
WebKit2UserMessagenew_with_fd_list 
since: 2.28 


Declaration 


WebKitUserMessage* 
webkit_user_message_new_with_fd_list ( 
const char* name, 
GVariant* parameters, 
GUnixFDList* fd_list 
) 


Description 


Create anew WebKitUserMessage including also a list of UNIX file descriptors to be sent. 
Available since: 2.28 

Parameters 

name 


Type: const char* 


The message name. 
The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


parameters 
Type: GVariant 


The message parameters as a GVariant. 


The argument can be NULL. 


The data is owned by the caller of the function. 


fd_list 
Type: GUnixFDList 


The message file descriptors. 


The argument can be NULL. 


The data is owned by the caller of the function. 


Return value 


Type: |WebKitUserMessage 


The newly created WebKitUserMessage object. 


The data is owned by the called function. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 
WebKit4UserMessagebet_fd_list 
since: 2.28 


Declaration 


GUnixFDList* 
webkit_user_message_get_fd_list ( 
WebKitUserMessage* message 


) 


Description 


Get the message list of file descritpor. 


Available since: 2.28 


Gets property |WebKit2.UserMessage:fd-list 


Return value 
Type: GUnixFDList 


The message list of file descriptors. 


The data is owned by the instance. 


The return value can be NULL. 
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API Version: 4.1 


Library Version: 2.42.4 
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Methods 
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Method 
WebKitUserMessageget_name 
since: 2.28 


Declaration 


const char* 
webkit_user_message_get_name ( 


WebKitUserMessage* message 


) 


Description 


Get the message name. 


Available since: 2.28 


Gets property |WebKit2.UserMessage:name 


Return value 
Type: const char* 


The message name. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


Generated by[gi-docgen]2023.3 


Method 
WebKit2UserMessageget_parameters 
since: 2.28 


Declaration 


GVariant* 
webkit_user_message_get_parameters ( 


WebKitUserMessage* message 


) 


Description 


Get the message parameters. 


Available since: 2.28 


Gets property |WebKit2.UserMessage:parameters 


Return value 
Type: GVariant 


The message parameters. 


The data is owned by the instance. 


The return value can be NULL. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
get_fd_list 
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Method 


WebKit2)UserMessagesend_reply 


since: 2.28 


Declaration 


void 

webkit_user_message_send_reply ( 
WebKitUserMessage* message, 
WebKitUserMessage* reply 

) 


Description 


Send a reply to an user message. 


If reply is floating, it’s consumed. You can only send a reply to a WebKitUserMessage that has 
been received. 


Available since: 2.28 


Parameters 


reply 


Type:|WebKitUserMessage 


A WebKitUserMessage to send as reply. 


The data is owned by the caller of the method. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
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Property 


WebKitdUserMessagetfd-list 


since: 2.28 


Declaration 


property fd-list: Gio.UnixFDList [ read, write, construct-only ] 


Description 


The UNIX file descriptors of the user message. 


Type: GUnixFDList 


Available since: 2.28 


Getter method |webkit_user_message_get_fd_list () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 
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Property 
WebKit2UserMessage:name 

since: 2.28 

Declaration 

property name: utf8 [ read, write, construct-only ] 


Description 


The name of the user message. 
Type: gchar* 


Available since: 2.28 


Default value NULL 


Getter method |webkit_user_message_get_name() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 
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Property 


WebKit2UserMessage;: parameters 


since: 2.28 


Declaration 


property parameters: GLib.Variant [ read, write, construct-only ] 


Description 


The parameters of the user message as a GVariant, or NULL if the message doesn’t include parameters. 
Note that only complete types are allowed. 


Type: GVariant 


Available since: 2.28 


Getter method |webkit_user_message_get_parameters () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 
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Type 


Constructors 


new|new_ephemeral|new_with_website_data_manager| 


Functions 


Instance methods 


get_spell_checking_enabled]get_spell_checking_ languages 


Properties 


local-storage-directoryJmemory-pressure-settings|process-swap-on-cross-site-navigation-enabled 
time-zone-override]use-system-appearance-for-scrollbars]|website-data-manager 


Signals 
automation-startedjdownload-started}initialize-notification-permissions|initialize-web-extensions 


luser-message-received 


Virtual methods 


automation_startedjdownload_started]initialize_notification_permissions|initialize_web_extensions 


Generated by[gi-docgen]2023.3 


Class 


WebKit2;WebContext 


unstable since: 4.1 


Description 


class WebKit2.WebContext : GObject.Object 


{ 
priv: WebKitWebContextPrivate* 


} 
Manages aspects common to all WebKitWebViews 
The WebKitWebContext manages all aspects common to all WebKitWebViews. 


You can define the WebKitCacheModel with webkit_web_context_set_cache_model(), depending on 
the needs of your application. You can access the WebKit SecurityManager to specify the behaviour 
of your application regarding security using webkit_web_context_get_security_manager(). 


It is also possible to change your preferred language or enable spell checking, using 
webkit_web_context_set_preferred_languages(), 
webkit_web_context_set_spell_checking_languages () 

and webkit_web_context_set_spell_checking_enabled(). 


You can use webkit_web_context_register_uri_scheme () to register custom URI schemes, 
and manage several other settings. 


TLS certificate validation failure is now treated as a transport error by default. To handle TLS failures 
differently, you can connect to WebKitWebView: : load-failed-with-tls-errors. 
Alternatively, you can use webkit_web_context_set_tls_errors_policy () to set the policy 
WEBKIT_TLS_ERRORS_POLICY_IGNORE; however, this is not appropriate for Internet applications. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitWebContext ancestor_0 GObject ancestor_0--this 


Ancestors 
@ GObject 


Constructors 


webkit_web_context_new 


Create anew WebKitWebContext. 
since: 2.8 
Create a new ephemeral WebKitWebContext. 


since: 2.16 


webkit_web_context_new_with_website_data_manager 


Create anew WebKitWebContext with aWebKitWebsiteDataManager. 


since: 2.10 


Functions 


webkit_web_context_get_default 


Gets the default web context. 


unstable since: 4.1 


Instance methods 


webkit_web_context_add_path_to_sandbox 


Adds a path to be mounted in the sandbox. 


since: 2.26 


webkit_web_context_allow_tls_certificate_for_host| 


Ignore further TLS errors on the host for the certificate present in info. 


since: 2.6 


webkit_web_context_clear_cache 


Clears all resources currently cached. 


unstable since: 4.1 


webkit_web_context_download_uri 


Requests downloading of the specified URI string. 


unstable since: 4.1 
webkit_web_context_get_cache_model 


Returns the current cache model. 
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webkit_web_context_get_cookie_manager 


Get the WebKitCookieManager of the context ‘s WebKitWebsiteDataManager. 


unstable since: 4.1 


webkit_web_context_get_favicon_database 


Get the WebKitFaviconDatabase associated with context. 


unstable since: 4.1 
webkit_web_context_get_favicon_database_directory 
Get the directory path to store the favicons database. 


unstable since: 4.1 


= 
© 


bkit_web_context_get_geolocation_manager 

Get the WebKitGeolocationManager of context. 
since: 2.26 

Asynchronously get the list of installed plugins. 


unstable deprecated: 2.32 since: 4.1 


= 
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bkit_web_context_get_plugins_finish 


Finish an asynchronous operation started with webkit_web_context_get_plugins. 


unstable deprecated: 2.32 since: 4.1 

Returns WEBKIT_PROCESS_MODEL_MULTIPLE_SECONDARY_PROCESSES. 
deprecated: 2.40 since: 2.4 

Get whether sandboxing is currently enabled. 

since: 2.26 

Get the WebKitSecurityManager of context. 

unstable since: 4.1 

Get whether spell checking feature is currently enabled. 

unstable since: 4.1 

Get the the list of spell checking languages. 

unstable since: 4.1 

webkit_web_context_get_time_zone_override 

Get the WebKitWebContext :time-zone-override property. 
since: 2.38 

Get the TLS errors policy of context. 


unstable deprecated: 2.32. since: 4.1 


webkit_web_context_get_use_system_appearance_for_scrollbars 


Get the WebKitWebContext :use-system—appearance-for-scrollbars property. 
since: 2.30 

[webkit_web_context_get_web_process_count_limit] 

Gets the maximum number of web processes that can be created at the same time for the context. 
deprecated: 2.26 since: 2.10 

[webkit_web_context_get_website_data_manager] 

Get the WebKitWebsiteDataManager of context. 


since: 2.10 


webkit_web_context_initialize_notification_permissions 


Sets initial desktop notification permissions for the context. 
since: 2.16 

webkit_web_context_is_automation_allowed| 

Get whether automation is allowed in context. 

since: 2.18 

Get whether a WebKitWebContext is ephemeral. 

since: 2.16 

[webkit_web_context_prefetch_dns 

Resolve the domain name of the given hostname in advance. 
unstable since: 4.1 

Register scheme in context. 


unstable since: 4.1 


webkit_web_context_send_message_to_all_extensions 


Send message to all web process extensions associated to context. 


since: 2.28 


webkit_web_context_set_additional_plugins_directory 


Set an additional directory where WebKit will look for plugins. 
unstable deprecated: 2.32 since: 4.1 
webkit_web_context_set_automation_allowed 

Set whether automation is allowed in context. 

since: 2.18 

webkit_web_context_set_cache_model 

Specifies a usage model for WebViews. 

unstable since: 4.1 
webkit_web_context_set_disk_cache_directory 

Set the directory where disk cache files will be stored. 

unstable deprecated: 2.10. since: 4.1 
webkit_web_context_set_favicon_database_directory 

Set the directory path to store the favicons database. 

unstable since: 4.1 

Set the network proxy settings to be used by connections started in context. 
deprecated: 2.32. since: 2.16 


Set the list of preferred languages. 


unstable since: 4.1 


webkit_web_context_set_process_model 


This function previously allowed specifying the process model to use. However, since 2.26, the only 
allowed process model is WEBKIT_PROCESS_MODEL_MULTIPLE_SECONDARY_PROCESSES, so this 
function does nothing. 


deprecated: 2.40 since: 2.4 

Set whether WebKit subprocesses will be sandboxed. 

since: 2.26 

Enable or disable the spell checking feature. 

unstable since: 4.1 

Set the list of spell checking languages to be used for spell checking. 
unstable since: 4.1 

Set the TLS errors policy of context as policy. 

unstable deprecated: 2.32. since: 4.1 


webkit_web_context_set_use_system_appearance_for_scrollbars 


Set the WebKitWebContext :use-system—appearance-for-—scrollbars property. 


since: 2.30 


webkit_web_context_set_web_extensions_directory 


Set the directory where WebKit will look for web process extensions. 


unstable since: 4.1 


webkit_web_context_set_web_extensions_initialization_user_data 


Set user data to be passed to web process extensions on initialization. 


since: 2.4 

Sets the maximum number of web processes. 
deprecated: 2.26 since: 2.10 

Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.WebContext:local-storage-directory 


The directory where local storage data will be saved. 
deprecated: 2.10. since: 2.8 
The WebKitMemoryPressureSettings applied to the web processes created by this context. 


since: 2.34 


WebKit2.WebContext:process-swap-on-cross-site-navigation-enabled 


Whether swap Web processes on cross-site navigations is enabled. 


since: 2.28 


WebKit2.WebContext:time-zone-override 


The timezone override for this web context. Setting this property provides a better alternative to configure 
the timezone information for all webviews managed by the WebContext. The other, less optimal, approach 
is to globally set the TZ environment variable in the process before creating the context. However this 
approach might not be very convenient and can have side-effects in your application. 


since: 2.38 
WebKit2.WebContext:use-system-appearance-for-scrollbars 
Whether to use system appearance for rendering scrollbars. 


since: 2.30 


WebKit2.WebContext: website-data-manager 


The WebKitWebsiteDataManager associated with this context. 


since: 2.10 


Signals 
WebKit2.WebContext::automation-started 


This signal is emitted when a new automation request is made. Note that it will never be emitted if 
automation is not enabled in context, see 
webkit_web_context_set_automation_allowed() for more details. 


since: 2.18 


WebKit2.WebContext::download-started 


This signal is emitted when a new download request is made. 


unstable since: 4.1 


WebKit2.WebContext: :initialize-notification-permissions 


This signal is emitted when a WebKitWebContext needs to set initial notification permissions for a 
web process. It is emitted when a new web process is about to be launched, and signals the most 
appropriate moment to use webkit_web_context_initialize_notification_permissions(). If no notification 
permissions have changed since the last time this signal was emitted, then there is no need to call 
webkit_web_context_initialize_notification_permissions () again. 


since: 2.16 


WebKit2.WebContext::initialize-web-extensions 


This signal is emitted when a new web process is about to be launched. It signals the most appropriate 
moment to use 
webkit_web_context_set_web_extensions_initialization_user_data () 

and webkit_web_context_set_web_extensions_directory(). 


since: 2.4 


WebKit2.WebContext::user-message-received 


This signal is emitted when a WebKitUserMessage is received from a web process extension. You can 
reply to the message using webkit_user_message_send_reply(). 


since: 2.28 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2WebContextClass { 

GObjectClass parent; 

void (* download_started) ( 
WebKitWebContext* context, 
WebKitDownload* download 

i 

void (* initialize_web_extensions) ( 
WebKitWebContext* context 

i 

void (* initialize_notification_permissions) ( 
WebKitWebContext* context 

i 

void (* automation_started) ( 
WebKitWebContext* context, 
WebKitAutomationSession* session 


i 

gboolean (* user_message_received) ( 
WebKitWebContext* context, 
WebKitUserMessage* messag 


i 

void (* _webkit_reserved0) ( 
void 

i 

void (* _webkit_reservedl) ( 
void 

i 

void (* _webkit_reserved2) ( 
void 


i 


} 


No description available. 
Class members 


parent: GObjectClass 

No description available. 
download_started: void (* download_started) ( WebKitWebContext* 
context, WebKitDownload* download ) 

No description available. 


initialize _web_extensions: void (* initialize _web_extensions) ( 
WebKitWebContext* context ) 

No description available. 
initialize_notification_permissions: void (* 


initialize_notification_permissions) ( WebKitWebContext* context ) 
No description available. 
automation_started: void (* automation_started) ( WebKitWebContext* 


context, WebKitAutomationSession* session ) 

No description available. 
user_message_received: gboolean (* user_message_received) ( 
WebKitWebContext* context, WebKitUserMessage* message ) 

No description available. 


_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 


No description available. 


Virtual methods 


WebKit2.WebContextClass.automation_started 


No description available. 


unstable since: 4.1 


WebKit2.WebContextClass.download_started 


No description available. 


unstable since: 4.1 


WebKit2.WebContextClass.initialize_notification_permissions 


No description available. 


unstable since: 4.1 


WebKit2.WebContextClass.initialize_web_extensions 


No description available. 


unstable since: 4.1 


WebKit2.WebContextClass.user_message_received 


No description available. 


unstable since: 4.1 
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WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


Constructors 


new_with_website_data_manager 
Generated by 2023.3 


Constructor 


WebKit2WebContextnew 


since: 2.8 


Declaration 


WebKitWebContext* 
webkit_web_context_new ( 
void 


) 


Description 


Create anew WebKitWebContext. 


Available since: 2.8 


Return value 


Type: |WebKitWebContext 


A newly created WebKitWebContext. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Constructors 


new_with_website_data_manager 
Generated by 2023.3 


Constructor 


WebKit2WebContextnew_ephemeral 


since: 2.16 


Declaration 


WebKitWebContext* 
webkit_web_context_new_ephemeral ( 
void 


) 


Description 


Create a new ephemeral WebKitWebContext. 


An ephemeral WebKitWebContext is a context created with an ephemeral 
WebKitWebsiteDataManager. This is just a convenient method to create ephemeral contexts 
without having to create your own WebKitWebsiteDataManager. All WebKitWebViews 
associated with this context will also be ephemeral. Websites will not store any data in the client storage. 
This is normally used to implement private instances. 


Available since: 2.16 


Return value 


Type: |WebKitWebContext 


A new ephemeral WebKitWebContext. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Constructors 


new_with_website_data_manager 
Generated by 2023.3 


Constructor 


WebKit J ebContextnew_with_website_data_manager 


since: 2.10 


Declaration 


WebKitWebContext* 
webkit_web_context_new_with_website_data_manager ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Create anew WebKitWebContext with aWebKitWebsiteDataManager. 


Available since: 2.10 


Parameters 


manager 


Type:|WebKitWebsiteDataManager 


A WebKitWebsiteDataManager. 


The data is owned by the caller of the function. 


Return value 


Type: |WebKitWebContext 


A newly created WebKitWebContext. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Functions 


Generated by[gi-docgen|2023.3 


Function 


WebKit2ZWebContextget_default 
Declaration 


WebKitWebContext* 
webkit_web_context_get_default ( 
void 


) 


Description 


Gets the default web context. 


Return value 


Type: |WebKitWebContext 


A WebKitWebContext. 


The data is owned by the called function. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2WebContextadd_path_to_sandbox 


since: 2.26 


Declaration 


void 
webkit_web_context_add_path_to_sandbox ( 
WebKitWebContext* context, 
const char* path, 
gboolean read_only 


) 


Description 


Adds a path to be mounted in the sandbox. 


path must exist before any web process has been created; otherwise, it will be silently ignored. It is a 
fatal error to add paths after a web process has been spawned. 


Paths under /sys, /proc, and /dev are invalid. Attempting to add all of / is not valid. Since 2.40, 
adding the user’s entire home directory or /home is also not valid. 


See also webkit_web_context_set_sandbox_enabled () 


Available since: 2.26 


Parameters 
path 
Type: const char* 
An absolute path to mount in the sandbox. 


The data is owned by the caller of the method. 


The value is a file system path, using the OS encoding. 


read_only 
Type: gboolean 


If TRUE the path will be read-only. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextallow_tls_certificate_for_host 


since: 2.6 


Declaration 


void 
webkit_web_context_allow_tls_certificate_for_host ( 
WebKitWebContext* context, 
GTlsCertificate* certificate, 
const gchar* host 


) 


Description 


Ignore further TLS errors on the host for the certificate present in info. 
Available since: 2.6 
Parameters 
certificate 
Type: GTlsCertificate 


AGTlsCertificate. 


The data is owned by the caller of the method. 


host 
Type: const gchar* 
The host for which a certificate is to be allowed. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2WebContexttlear_cache 
Declaration 


void 

webkit_web_context_clear_cache ( 
WebKitWebContext* context 

) 


Description 


Clears all resources currently cached. 


See also webkit_web_context_set_cache_model(). 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2WebContextdownload_uri 
Declaration 


WebKitDownload* 

webkit_web_context_download_uri ( 
WebKitWebContext* context, 
const gchar* uri 


) 


Description 


Requests downloading of the specified URI string. 


The download operation will not be associated to any WebKitWebView, if you are interested in starting 
a download from a particular WebKitWebView use webkit_web_view_download_uri () 
instead. 


Parameters 
uri 


Type: const gchar* 
The URI to download. 
The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitDownload 


A new WebKitDown1load representing the download operation. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextget_cache_model 
Declaration 


WebKitCacheModel 

webkit_web_context_get_cache_model ( 
WebKitWebContext* context 

) 


Description 


Returns the current cache model. 


For more information about this value check the documentation of the 
function webkit_web_context_set_cache_model(). 


Return value 


Type: |WebKitCacheModel 


The current WebKitCacheModel. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextget_cookie_manager 
Declaration 


WebKitCookieManager* 

webkit_web_context_get_cookie_manager ( 
WebKitWebContext* context 

) 


Description 


Get the WebKitCookieManager of the context ‘s WebKitWebsiteDataManager. 


Return value 


Type: |WebKitCookieManager 


The WebKitCookieManager of context. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextget_favicon_database 
Declaration 


WebKitFaviconDatabase* 

webkit_web_context_get_favicon_database ( 
WebKitWebContext* context 

) 


Description 


Get the WebKitFaviconDatabase associated with context. 


To initialize the database you need to call webkit_web_context_set_favicon_database_directory(). 


Return value 


Type: |WebKitFaviconDatabase 


The WebKitFaviconDatabase of context. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextget_favicon_database_directory 
Declaration 


const gchar* 

webkit_web_context_get_favicon_database_directory ( 
WebKitWebContext* context 

) 


Description 


Get the directory path to store the favicons database. 


Get the directory path being used to store the favicons database for context, or NULL if 
webkit_web_context_set_favicon_database_directory () hasn’t been called yet. 


This function will always return the same path after having called 
webkit_web_context_set_favicon_database_directory () for the first time. 


Return value 
Type: const gchar* 


The path of the directory of the favicons database associated with context, or NULL. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 


Method 
WebKit J ebContextget_geolocation_manager 
since: 2.26 


Declaration 


WebKitGeolocationManager* 

webkit_web_context_get_geolocation_manager ( 
WebKitWebContext* context 

) 


Description 


Get the WebKitGeolocationManager of context. 


Available since: 2.26 


Return value 


Type: |WebKitGeolocationManager 


The WebKitGeolocationManager of context. 


The data is owned by the instance. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2WebContextget_plugins 


deprecated: 2.32 


Declaration 


void 


webkit_web_context_get_plugins ( 
WebKitWebContext* context, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


) 


Description 


Asynchronously get the list of installed plugins. 


When the operation is finished, callback will be called. You can then call 
webkit_web_context_get_plugins_finish () to get the result of the operation. 


Deprecated since: 2.32 
Please do not use it in newly written code. 
Parameters 
cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2ZWebContextget_plugins_finish 


deprecated: 2.32 


Declaration 


GList* 
webkit_web_context_get_plugins_finish ( 
WebKitWebContext* context, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_web_context_get_plugins. 


Deprecated since: 2.32 


Please do not use it in newly written code. 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 

Return value 

Type: A list of WebKitPlugin* 


A GList of WebKitPlugin. You must free the GList with g_list_free() and unref the 
WebKitPlugins with g_object_unref () when you’re done with them. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextget_process_model 


deprecated: 2.40 since: 2.4 


Declaration 


WebKitProcessModel 

webkit_web_context_get_process_model ( 
WebKitWebContext* context 

) 


Description 


Returns WEBKIT_PROCESS_MODEL_MULTIPLE_SECONDARY_PROCESSES. 


For more information about why this function is deprecated, 
see webkit_web_context_set_process_model(). 


Available since: 2.4 
Deprecated since: 2.40 


Please do not use it in newly written code. 


Return value 


Type: |WebKitProcessModel 


WEBKIT_PROCESS_MODEL_ MULTIPLE_SECONDARY_PROCESSES. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2WebContextget_sandbox_enabled 


since: 2.26 


Declaration 


gboolean 

webkit_web_context_get_sandbox_enabled ( 
WebKitWebContext* context 

) 


Description 


Get whether sandboxing is currently enabled. 
Available since: 2.26 

Return value 

Type: gboolean 


TRUE if sandboxing is enabled, or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextget_security_manager 
Declaration 


WebKitSecurityManager* 

webkit_web_context_get_security_manager ( 
WebKitWebContext* context 

) 


Description 


Get the WebKitSecurityManager of context. 


Return value 


Type: |WebKitSecurityManager 


The WebKitSecurityManager of context. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextget_spell_checking_ enabled 
Declaration 


gboolean 

webkit_web_context_get_spell_checking_enabled ( 
WebKitWebContext* context 

) 


Description 


Get whether spell checking feature is currently enabled. 


Return value 
Type: gboolean 


TRUE If spell checking is enabled, or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2WebContextget_spell_checking_languages 
Declaration 


const gchar* const* 

webkit_web_context_get_spell_checking_languages ( 
WebKitWebContext* context 

) 


Description 


Get the the list of spell checking languages. 


Get the the list of spell checking languages associated with context, or NULL if no languages have been 
previously set. 


See webkit_web_context_set_spell_checking_languages () for more details on the 
format of the languages in the list. 


Return value 

Type: An array of ut £8 

A NULL-terminated array of languages if available, or NULL otherwise. 
The array is NULL-terminated. 


The data is owned by the instance. 


Each element is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 


Method 
WebKit J ebContextget_time_zone_override 
since: 2.38 


Declaration 


const gchar* 

webkit_web_context_get_time_zone_override ( 
WebKitWebContext* context 

) 


Description 


Get the WebKitWebContext :time-zone-override property. 


Available since: 2.38 


Gets property |WebKit2.WebContext:time-zone-override 


Return value 
Type: const gchar* 
No description available. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextget_tls_errors_policy 


deprecated: 2.32. 


Declaration 


WebKitTLSErrorsPolicy 

webkit_web_context_get_tls_errors_policy ( 
WebKitWebContext* context 

) 


Description 


Get the TLS errors policy of context. 

Deprecated since: 2.32. 

Use webkit_website_data_manager_get_tls_errors_policy () instead. 
Return value 


Type: |WebKitTLSErrorsPolicy 


A WebKit TLSErrorsPolicy. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen]2023.3 
Method 


WebKit J ebContextget_use_system_appearance_for_scrollbars 


since: 2.30 


Declaration 


gboolean 

webkit_web_context_get_use_system_appearance_for_scrollbars ( 
WebKitWebContext* context 

) 


Description 


Get the WebKitWebContext :use-system—appearance-for-scrollbars property. 


Available since: 2.30 


Gets property |WebKit2.WebContext:use-system—appearance-for-scrollbars 


Return value 
Type: gboolean 


TRUE if scrollbars are rendering using the system appearance, or FALSE otherwise. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit | ebContextget_web_process_count_limit 


deprecated: 2.26 since: 2.10 


Declaration 


guint 

webkit_web_context_get_web_process_count_limit ( 
WebKitWebContext* context 

) 


Description 


Gets the maximum number of web processes that can be created at the same time for the context. 


This function is now deprecated and always returns 0 (no limit). See 
also webkit_web_context_set_web_process_count_limit(). 


Available since: 2.10 

Deprecated since: 2.26 

Please do not use it in newly written code. 
Return value 

Type: guint 


The maximum limit of web processes, or 0 if there isn’t a limit. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 


Method 
WebKit J ebContextget_website_data_manager 
since: 2.10 


Declaration 


WebKitWebsiteDataManager* 

webkit_web_context_get_website_data_manager ( 
WebKitWebContext* context 

) 


Description 


Get the WebKitWebsiteDataManager of context. 


Available since: 2.10 


Gets property |WebKit2.WebContext:website-data-manager 


Return value 


Type: |WebKitWebsiteDataManager 


A WebKitWebsiteDataManager. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2WebContextinitialize_notification_permissions 


since: 2.16 
Declaration 
void 


webkit_web_context_initialize_notification_permissions ( 
WebKitWebContext* context, 
GList* allowed_origins, 
GList* disallowed_origins 


) 


Description 


Sets initial desktop notification permissions for the context. 


allowed_origins and disallowed_origins must each be GList of 
WebKitSecurityOrigin objects representing origins that will, respectively, either always or never 
have permission to show desktop notifications. No WebKitNotificationPermissionRequest 
will ever be generated for any of the security origins represented in al lowed_origins or 
disallowed_origins. This function is necessary because some webpages proactively check whether 
they have permission to display notifications without ever creating a permission request. 


This function only affects web processes that have not already been created. The best time to call it is 
when handling WebKitWebContext::initialize-notification-permissions so as to 
ensure that new web processes receive the most recent set of permissions. 


Available since: 2.16 
Parameters 
allowed_origins 
Type: A list of WebKitSecurityOrigin* 


A GList of security origins. 


The data is owned by the caller of the method. 


disallowed_origins 
Type: A list of WebKitSecurityOrigin* 


A GList of security origins. 


The data is owned by the caller of the method. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 
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Method 


WebKit J ebContextis_automation_allowed 


since: 2.18 


Declaration 


gboolean 

webkit_web_context_is_automation_allowed ( 
WebKitWebContext* context 

) 


Description 


Get whether automation is allowed in context. 


See also webkit_web_context_set_automation_allowed(). 


Available since: 2.18 
Return value 
Type: gboolean 


TRUE if automation is allowed or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2WebContextis_ephemeral 


since: 2.16 


Declaration 


gboolean 

webkit_web_context_is_ephemeral ( 
WebKitWebContext* context 

) 


Description 


Get whether a WebKitWebContext is ephemeral. 
Available since: 2.16 

Return value 

Type: gboolean 


TRUE if context is ephemeral or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2WebContextprefetch_dns 
Declaration 


void 

webkit_web_context_prefetch_dns ( 
WebKitWebContext* context, 
const gchar* hostname 


) 


Description 


Resolve the domain name of the given hostname in advance. 


Resolve the domain name of the given hostname in advance, so that if a URI of hostname is requested 
the load will be performed more quickly. 


Parameters 
hostname 
Type: const gchar* 
A hostname to be resolved. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 
set_network_proxy_settings 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextregister_uri_scheme 
Declaration 


void 
webkit_web_context_register_uri_scheme ( 
WebKitWebContext* context, 
const gchar* scheme, 
WebKitURISchemeRequestCallback callback, 
gpointer user_data, 
GDestroyNotify user_data_destroy_func 


Description 


Register scheme in context. 


Register scheme in context, so that when an URI request with scheme is made in the 
WebKitWebContext, the WebKitURISchemeRequestCallback registered will be called with a 
WebKitURISchemeRequest. It is possible to handle URI scheme requests asynchronously, by calling 
g_object_ref() on the WebKitURISchemeRequest and calling 
webkit_uri_scheme_request_finish() later when the data of the request is available or 
webkit_uri_scheme_request_finish_error () incase of error. 

static void 


about_uri_scheme_request_cb (WebKitURISchemeRequest *request, 
gpointer user_data) 


{ 
GInputStream *stream; 
gsize stream_length; 
const gchar *path = webkit_uri_scheme_request_get_path (request); 


if (!g_strcempO (path, "memory")) { 
// Create a GInputStream with the contents of memory about page, and set its length to stream_length 
} else if (!g_strcmp0O (path, "applications")) { 
// Create a GInputStream with the contents of applications about page, and set its length to stream_length 


} else if (!g_strcmpO (path, "“example")) { 
gchar *contents = g_strdup_printf ("<html><body><p>Example about page</p></body></html1>") ; 
stream_length = strlen (contents); 
stream = g_memory_input_stream_new_from_data (contents, stream_length, g_free); 

} else { 


GError *error = g_error_new (ABOUT_HANDLER_ERROR, ABOUT_HANDLER_ERROR_INVALID, "Invalid about:%s page.", path); 
webkit_uri_scheme_request_finish_error (request, error); 

g_error_free (error); 

return; 


} 
webkit_uri_scheme_request_finish (request, stream, stream_length, "text/html"); 
g_object_unref (stream); 


Parameters 
scheme 
Type: const gchar* 
The network scheme to register. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


callback 


Type: |WebKitURISchemeRequestCallback 


A WebKitURISchemeRequestCallback. 


user_data 
Type: gpointer 
Data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 


user_data_destroy_func 
Type: GDestroyNotify 


Destroy notify for user_data. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextsend_message_to_all_ extensions 


since: 2.28 


Declaration 


void 
webkit_web_context_send_message_to_all_extensions ( 
WebKitWebContext* context, 
WebKitUserMessage* message 


) 


Description 


Send message to all web process extensions associated to context. 
If message is floating, it’s consumed. 


Available since: 2.28 


Parameters 


message 


Type:\WebKitUserMessage 


A WebKitUserMessage. 


The data is owned by the caller of the method. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextset_additional_plugins_directory 


deprecated: 2.32 


Declaration 


void 
webkit_web_context_set_additional_plugins_directory ( 
WebKitWebContext* context, 
const gchar* directory 


) 


Description 
Set an additional directory where WebKit will look for plugins. 
Deprecated since: 2.32 
Please do not use it in newly written code. 
Parameters 
directory 
Type: const gchar* 
The directory to add. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextset_automation_allowed 


since: 2.18 


Declaration 


void 
webkit_web_context_set_automation_allowed ( 
WebKitWebContext* context, 
gboolean allowed 
) 


Description 


Set whether automation is allowed in context. 


When automation is enabled the browser could be controlled by another process by requesting an 
automation session. When a new automation session is requested the signal 

WebKitWebContext: :automation-started is emitted. Automation is disabled by default, so 
you need to explicitly call this method passing TRUE to enable it. 


Note that only one WebKitWebContext can have automation enabled, so this will do nothing if there’s 
another WebKitWebContext with automation already enabled. 


Available since: 2.18 
Parameters 
allowed 

Type: gboolean 


Value to set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextset_cache_model 
Declaration 


void 

webkit_web_context_set_cache_model ( 
WebKitWebContext* context, 
WebKitCacheModel cache_model 

) 


Description 


Specifies a usage model for WebViews. 


Specifies a usage model for WebViews, which WebKit will use to determine its caching behavior. All web 
views follow the cache model. This cache model determines the RAM and disk space to use for caching 
previously viewed content . 


Research indicates that users tend to browse within clusters of documents that hold resources in common, 
and to revisit previously visited documents. WebKit and the frameworks below it include built-in caches 
that take advantage of these patterns, substantially improving document load speed in browsing situations. 
The WebKit cache model controls the behaviors of all of these caches, including various WebCore caches. 


Browsers can improve document load speed substantially by specifying 
WEBKIT_CACHE_MODEL_WEB_BROWSER. Applications without a browsing interface can reduce 
memory usage substantially by specifying WEBKIT_CACHE_MODEL_DOCUMENT_VIEWER. The default 
value is WEBKIT_CACHE_MODEL_WEB_BROWSER. 


Parameters 


cache_model 


Type: |WebKitCacheModel 


A WebKitCacheModel. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit | ebContextset_disk_cache_directory 


deprecated: 2.10. 


Declaration 


void 
webkit_web_context_set_disk_cache_directory ( 
WebKitWebContext* context, 
const gchar* directory 


) 


Description 


Set the directory where disk cache files will be stored. 
This method must be called before loading anything in this context, otherwise it will not have any effect. 


Note that this method overrides the directory set in the WebKitWebsiteDataManager, but it doesn’t 
change the value returned by 
webkit_website_data_manager_get_disk_cache_directory () since the 
WebKitWebsiteDataManager is immutable. 


Deprecated since: 2.10. 
Use webkit_web_context_new_with_website_data_manager () instead. 
Parameters 
directory 
Type: const gchar* 
The directory to set. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextset_favicon_database_directory 
Declaration 


void 
webkit_web_context_set_favicon_database_directory ( 
WebKitWebContext* context, 
const gchar* path 
) 


Description 


Set the directory path to store the favicons database. 


Set the directory path to be used to store the favicons database for context on disk. Passing NULL as 
path means using the default directory for the platform (see g_get_user_cache_dir()). 


Calling this method also means enabling the favicons database for its use from the applications, so that’s 
why it’s expected to be called only once. Further calls for the same instance of WebKitWebContext 
won't cause any effect. 


Parameters 
path 
Type: const gchar* 
An absolute path to the icon database directory or NULL to use the defaults. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextset_network_proxy_settings 


deprecated: 2.32. since: 2.16 


Declaration 


void 

webkit_web_context_set_network_proxy_settings ( 
WebKitWebContext* context, 
WebKitNetworkProxyMode proxy_mode, 
WebKitNetworkProxySettings* proxy_settings 

) 


Description 


Set the network proxy settings to be used by connections started in context. 


By default WEBKIT_NETWORK_PROXY_MODE_DEFAULT is used, which means that the system settings 
will be used (g_proxy_resolver_get_default()). If you want to override the system default settings, you can 
either use WEBKIT_NETWORK_PROXY_MODE_NO_PROXY to make sure no proxies are used at all, or 
WEBKIT_NETWORK_PROXY_MODE_CUSTOM to provide your own proxy settings. When proxy_mode 
is WEBKIT_NETWORK_PROXY_MODE_CUSTOM proxy_settings must be a valid 
WebKitNetworkProxySettings; otherwise, proxy_settings must be NULL. 


Available since: 2.16 
Deprecated since: 2.32. 


Use webkit_website_data_manager_set_network_proxy_settings () instead. 


Parameters 


proxy_mode 


Type:|WebKitNetworkProxyMode 


A WebKitNetworkProxyMode. 


proxy_settings 


Type: |WebKitNetworkProxySettings 


A WebKitNetworkProxySettings, or NULL. 


The argument can be NULL. 


The data is owned by the caller of the method. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2ZWebContextbet_preferred_languages 
Declaration 


void 
webkit_web_context_set_preferred_languages ( 
WebKitWebContext* context, 
const gchar* const* languages 


) 


Description 


Set the list of preferred languages. 


Set the list of preferred languages, sorted from most desirable to least desirable. The list will be used in the 
following ways: 


@ Determining how to build the Accept-Language HTTP header that will be included in the 
network requests started by the WebKitWebContext. 

@ Setting the values of navigator. language and navigator. languages. 

@ The first item in the list sets the default locale for JavaScript Int 1 functions. 


Parameters 
languages 
Type: An array of ut £8 
A NULL-terminated list of language identifiers. 
The argument can be NULL. 
The array must be NULL-terminated. 


The data is owned by the caller of the method. 


Each element is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextset_process_model 


deprecated: 2.40 since: 2.4 


Declaration 


void 


webkit_web_context_set_process_model ( 
WebKitWebContext* context, 
WebKitProcessModel process_model 

) 


Description 


This function previously allowed specifying the process model to use. However, since 2.26, the only 
allowed process model is WEBKIT_PROCESS_MODEL_MULTIPLE_SECONDARY_PROCESSES, so this 
function does nothing. 


Available since: 2.4 
Deprecated since: 2.40 


Please do not use it in newly written code. 


Parameters 


process_model 


Type:|(WebKitProcessModel 


A WebKitProcessModel. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextset_sandbox_enabled 


since: 2.26 


Declaration 


void 
webkit_web_context_set_sandbox_enabled ( 
WebKitWebContext* context, 
gboolean enabled 
) 


Description 


Set whether WebKit subprocesses will be sandboxed. 

Set whether WebKit subprocesses will be sandboxed, limiting access to the system. This method must be 
called before any web process has been created, as early as possible in your application. Calling it later 
is a fatal error. 

This is only implemented on Linux and is a no-op otherwise. 

Available since: 2.26 

Parameters 

enabled 


Type: gboolean 


If TRUE enable sandboxing. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextset_spell_checking_enabled 
Declaration 


void 
webkit_web_context_set_spell_checking_enabled ( 
WebKitWebContext* context, 
gboolean enabled 
) 


Description 


Enable or disable the spell checking feature. 


Parameters 
enabled 
Type: gboolean 


Value to be set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2WebContextbet_spell_checking_languages 
Declaration 


void 
webkit_web_context_set_spell_checking_languages ( 
WebKitWebContext* context, 
const gchar* const* languages 


) 


Description 


Set the list of spell checking languages to be used for spell checking. 


The locale string typically is in the form lang COUNTRY, where lang is an ISO-639 language code, and 
COUNTRY is an ISO-3166 country code. For instance, sv_FI for Swedish as written in Finland or pt_BR 
for Portuguese as written in Brazil. 


You need to call this function with a valid list of languages at least once in order to properly enable the 
spell checking feature in WebKit. 


Parameters 
languages 
Type: An array of gchar* 
A NULL-terminated list of spell checking languages. 
The array must be NULL-terminated. 


The data is owned by the caller of the method. 


Each element is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextset_tls_errors_policy 


deprecated: 2.32. 


Declaration 


void 

webkit_web_context_set_tls_errors_policy ( 
WebKitWebContext* context, 
WebKitTLSErrorsPolicy policy 

) 


Description 


Set the TLS errors policy of context as policy. 

Deprecated since: 2.32. 

Use webkit_website_data_manager_set_tls_errors_policy () instead. 
Parameters 

policy 


Type:\(WebKitTLSErrorsPolicy 


A WebKit TLSErrorsPolicy. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen]2023.3 
Method 


WebKit J ebContextset_use_system_appearance_for_scrollbars 


since: 2.30 
Declaration 
void 


webkit_web_context_set_use_system_appearance_for_scrollbars ( 
WebKitWebContext* context, 
gboolean enabled 


) 


Description 


Set the WebKitWebContext :use-system—appearance-for-—scrollbars property. 


Available since: 2.30 


Sets property |WebKit2.WebContext:use-system—-appearance-for-scrollbars 


Parameters 
enabled 
Type: gboolean 


Value to set. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit J ebContextset_web_extensions_directory 
Declaration 


void 
webkit_web_context_set_web_extensions_directory ( 
WebKitWebContext* context, 
const gchar* directory 


) 


Description 


Set the directory where WebKit will look for web process extensions. 


This method must be called before loading anything in this context, otherwise it will not have any effect. 
You can connect to WebKitWebContext::initialize-web-—extensions to call this method 
before anything is loaded. 


Parameters 

directory 
Type: const gchar* 
The directory to add. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit2|WebContextset_web_extensions_initialization_user_data 


since: 2.4 
Declaration 
void 


webkit_web_context_set_web_extensions_initialization_user_data ( 
WebKitWebContext* context, 
GVariant* user_data 


) 


Description 


Set user data to be passed to web process extensions on initialization. 


The data will be passed to the WebKitWebExtensionInitializeWithUserDataFunction. 
This method must be called before loading anything in this context, otherwise it will not have any effect. 
You can connect to WebKitWebContext::initialize-web-—extensions to call this method 
before anything is loaded. 


Available since: 2.4 
Parameters 
user_data 

Type: GVariant 


A GVariant. 


The data is owned by the caller of the method. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


get_spell_ checking enabled|get_spell_checking_ languages 


Generated by[gi-docgen|2023.3 
Method 


WebKit | ebContextset_web_process_count_limit 


deprecated: 2.26 since: 2.10 


Declaration 


void 
webkit_web_context_set_web_process_count_limit ( 
WebKitWebContext* context, 
guint limit 


) 


Description 


Sets the maximum number of web processes. 


Sets the maximum number of web processes that can be created at the same time for the context. The 
default value is 0 and means no limit. 


This function is now deprecated and does nothing for security reasons. 
Available since: 2.10 
Deprecated since: 2.26 
Please do not use it in newly written code. 
Parameters 
limit 
Type: guint 


The maximum number of web processes. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Properties 


local-storage-directoryJmemory-pressure-settings|process-swap-on-cross-site-navigation-enabled 
time-zone-override]use-system-appearance-for-scrollbars]|website-data-manager 


Generated by[gi-docgen]2023.3 


Property 


WebKit2ZWebContexttlocal-storage-directory 


deprecated: 2.10. since: 2.8 


Declaration 


property local-storage-directory: utf8 [ read, write, construct-only ] 


Description 


The directory where local storage data will be saved. 


Type: gchar* 
Available since: 2.8 
Deprecated since: 2.10. 


Use WebKitWebsiteDataManager:local-storage-directory instead. 


Default value NULL 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Properties 


local-storage-directoryJmemory-pressure-settings|process-swap-on-cross-site-navigation-enabled 
time-zone-override]use-system-appearance-for-scrollbars]|website-data-manager 


Generated by[gi-docgen]2023.3 


Property 
WebKit2WebContexttmemory-pressure-settings 
since: 2.34 

Declaration 


property memory-pressure-settings: WebKit2.MemoryPressureSettings [ write, construct-only ] 


Description 


The WebKitMemoryPressureSettings applied to the web processes created by this context. 


Type: WebKitMemoryPressureSettings 


Available since: 2.34 


Flags 
Readable no 
Writable yes 
Construct no 


Construct only yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Properties 


local-storage-directoryJmemory-pressure-settings|process-swap-on-cross-site-navigation-enabled 
time-zone-override]use-system-appearance-for-scrollbars]|website-data-manager 


Generated by[gi-docgen]2023.3 


Property 


WebKit2WebContexttprocess-swap-on-cross-site-navigation-enabled 


since: 2.28 


Declaration 


property process-—swap-on-cross-site-navigation-enabled: gboolean [ read, write, construct-only ] 
Description |[src] 
Whether swap Web processes on cross-site navigations is enabled. 


When enabled, pages from each security origin will be handled by their own separate Web processes, 
which are started (and terminated) on demand as the user navigates across different domains. This is an 
important security measure which helps prevent websites stealing data from other visited pages. 


Type: gboolean 
Available since: 2.28 


Default value FALSE 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


local-storage-directoryJmemory-pressure-settings|process-swap-on-cross-site-navigation-enabled 
time-zone-override]use-system-appearance-for-scrollbars]|website-data-manager 


Generated by[gi-docgen]2023.3 


Property 
WebKit2WebContextttime-zone-override 
since: 2.38 

Declaration 

property time-zone-override: utf8 [ read, write, construct-only ] 


Description 


The timezone override for this web context. Setting this property provides a better alternative to configure 
the timezone information for all webviews managed by the WebContext. The other, less optimal, approach 
is to globally set the TZ environment variable in the process before creating the context. However this 
approach might not be very convenient and can have side-effects in your application. 


The expected values for this property are defined in the [ANA timezone database. See this wikipedia page 
for instance, https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. 


Type: gchar* 


Available since: 2.38 


Default value NULL 


Getter method |webkit_web_context_get_time_zone_override() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Properties 


local-storage-directoryJmemory-pressure-settings|process-swap-on-cross-site-navigation-enabled 
time-zone-override]use-system-appearance-for-scrollbars]|website-data-manager 


Generated by[gi-docgen]2023.3 


Property 
WebKit2WebContexttuse-system-appearance-for-scrollbars 
since: 2.30 

Declaration 

property use-system-appearance-for-scrollbars: gboolean [ read, write, construct ] 


Description 


Whether to use system appearance for rendering scrollbars. 


This is enabled by default for backwards compatibility, but it’s only recommened to use when the 
application includes other widgets to ensure consistency, or when consistency with other applications is 
required too. 


Type: gboolean 
Available since: 2.30 


Default 


TRUE 

value 

Getter = 
webkit_web_context_get_use_system_appearance_for_scrollbars() 

method 

Setter = 
webkit_web_context_set_use_system_appearance_for_ scrollbars () 

method 

Flags 

Readable yes 

Writable yes 

Construct yes 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Properties 


local-storage-directoryJmemory-pressure-settings|process-swap-on-cross-site-navigation-enabled 
time-zone-override]use-system-appearance-for-scrollbars]|website-data-manager 


Generated by[gi-docgen]2023.3 


Property 

WebKit2WebContextt website-data-manager 
since: 2.10 

Declaration 


property website-data-manager: WebKit2.WebsiteDataManager [ read, write, construct-only ] 


Description 


The WebKitWebsiteDataManager associated with this context. 


Type: WebKitWebsiteDataManager 


Available since: 2.10 


Getter method |webkit_web_context_get_website_data_manager () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Signals 


automation-startedjdownload-started}initialize-notification-permissions|initialize-web-extensions 
luser-message-received| 


Generated by[gi-docgen]2023.3 


Signal 
WebKit2WebContextt:automation-started 
since: 2.18 

Declaration 


automation_started ( 
WebKitWebContext* self, 
WebKitAutomationSession* session, 
gpointer user_data 

) 


Description 


This signal is emitted when a new automation request is made. Note that it will never be emitted if 
automation is not enabled in context, see 
webkit_web_context_set_automation_allowed() for more details. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.18 


Parameters 


session 


Type:|(WebKitAutomationSession 


The WebKitAutomationSession associated with this event. 


The data is owned by the caller of the function. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Signals 


automation-startedjdownload-started}initialize-notification-permissions|initialize-web-extensions 
luser-message-received| 


Generated by[gi-docgen]2023.3 


Signal 


WebKit2WebContextt:download-started 


unstable since: 4.1 


Declaration 


void 

download_started ( 
WebKitWebContext* self, 
WebKitDownload* download, 
gpointer user_data 


) 


Description 


This signal is emitted when a new download request is made. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


download 


Type:|WebKitDownload 


The WebKitDownload associated with this event. 


The data is owned by the caller of the function. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


automation-startedjdownload-started}initialize-notification-permissions|initialize-web-extensions 
luser-message-received| 


Generated by[gi-docgen]2023.3 


Signal 


WebKit2WebContext:initialize-notification-permissions 


since: 2.16 


Declaration 


void 
initialize_notification_permissions ( 
WebKitWebContext* self, 
gpointer user_data 


) 


Description 


This signal is emitted when a WebKitWebContext needs to set initial notification permissions for a 
web process. It is emitted when a new web process is about to be launched, and signals the most 
appropriate moment to use webkit_web_context_initialize_notification_permissions(). If no notification 
permissions have changed since the last time this signal was emitted, then there is no need to call 
webkit_web_context_initialize_notification_permissions () again. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.16 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Signals 


automation-startedjdownload-started}initialize-notification-permissions|initialize-web-extensions 
luser-message-received| 


Generated by[gi-docgen]2023.3 


Signal 
WebKit2WebContextt:initialize-web-extensions 
since: 2.4 

Declaration 

void 


initialize_web_extensions ( 
WebKitWebContext* self, 
gpointer user_data 


) 


Description 


This signal is emitted when a new web process is about to be launched. It signals the most appropriate 
moment to use 
webkit_web_context_set_web_extensions_initialization_user_data () 

and webkit_web_context_set_web_extensions_directory(). 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.4 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


automation-startedjdownload-started}initialize-notification-permissions|initialize-web-extensions 
luser-message-received| 
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Signal 


WebKit2WebContextt :user-message-received 


since: 2.28 


Declaration 


gboolean 

user_message_received ( 
WebKitWebContext* self, 
WebKitUserMessage* message, 
gpointer user_data 

) 


Description 


This signal is emitted when a WebKitUserMessage is received from a web process extension. You can 
reply to the message using webkit_user_message_send_reply(). 


You can handle the user message asynchronously by calling g_object_ref () onmessage and 
returning TRUE. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.28 


Parameters 


message 


Type:|WebKitUserMessage 


The WebKitUserMessage received. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE if the message was handled, or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Virtual methods 


automation_startedjdownload_started]initialize_notification_permissions|initialize_web_extensions 
luser_message_received 
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Virtual Method 


WebKit2WebContexthutomation_started 
Declaration 


void 

automation_started ( 
WebKitWebContext* context, 
WebKitAutomationSession* session 


) 


Description 


No description available. 


Parameters 


session 


Type:|(WebKitAutomationSession 


No description available. 


The data is owned by the caller of the function. 
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Library Version: 2.42.4 
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Virtual methods 
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Virtual Method 


WebKit2WebContextdownload_started 
Declaration 


void 

download_started ( 
WebKitWebContext* context, 
WebKitDownload* download 

) 


Description 


No description available. 


Parameters 


download 


Type:|WebKitDownload 


No description available. 


The data is owned by the caller of the function. 
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API Version: 4.1 


Library Version: 2.42.4 
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Virtual methods 
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Generated by[gi-docgen]2023.3 
Virtual Method 


WebKit2ZWebContextinitialize_notification_permissions 
Declaration 


void 

initialize_notification_permissions ( 
WebKitWebContext* context 

) 


Description 


No description available. 
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Library Version: 2.42.4 


Type 


Virtual methods 
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Virtual Method 


WebKit J ebContextinitialize_web_extensions 
Declaration 


void 
initialize_web_extensions ( 

WebKitWebContext* context 
) 


Description 


No description available. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 


Virtual methods 


automation_startedjdownload_started]initialize_notification_permissions|initialize_web_extensions 
luser_message_received 


Generated by[gi-docgen]2023.3 
Virtual Method 


WebKit J ebContextuser_message_received 
Declaration 


gboolean 

user_message_received ( 
WebKitWebContext* context, 
WebKitUserMessage* message 


) 


Description 


No description available. 


Parameters 


message 


Type:|WebKitUserMessage 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 
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Library Version: 2.42.4 
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Instance methods 
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Properties 
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Class 


WebKit2/WebInspector 


unstable since: 4.1 


Description 


class WebKit2.WebInspector : GObject.Object 
{ 
priv: WebKitWebInspectorPrivate* 


} 
Access to the WebKit inspector. 


The WebKit Inspector is a graphical tool to inspect and change the content of aWebKitWebView. It also 
includes an interactive JavaScript debugger. Using this class one can get a GtkWidget which can be 
embedded into an application to show the inspector. 


The inspector is available when the WebKitSettings of the WebKitWebView has set the 
WebKitSettings:enable-developer-ext ras to true, otherwise no inspector is available. 


// Enable the developer extras 
WebKitSettings *settings = webkit_web_view_get_settings (WEBKIT_WEB_VIEW (my_webview) ) ; 
g_object_set (G_OBJECT(settings), "“enable-developer-extras", TRUE, NULL); 


// Load some data or reload to be able to inspect the page 
webkit_web_view_load_uri (WEBKIT_WEB_VIEW(my_webview), "http://www.gnome.org") ; 


// Show the inspector 
WebKitWebInspector *inspector = webkit_web_view_get_inspector (WEBKIT_WEB_VIEW(my_webview) ); 
webkit_web_inspector_show (WEBKIT_WEB_INSPECTOR (inspector) ); 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitWebInspector ancestor_O0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Instance methods 


webkit_web_inspector_attach 


Request inspector to be attached. 

unstable since: 4.1 

Request inspector to be closed. 

unstable since: 4.1 

Request inspector to be detached. 

unstable since: 4.1 

Get the height that the inspector view when attached. 


unstable since: 4.1 


webkit_web_inspector_get_can_attach 

Whether the inspector can be attached to the same window that contains the inspected view. 
since: 2.8 

[webkit_web_inspector_get_inspected_urij 

Get the URI that is currently being inspected. 

unstable since: 4.1 

Get the WebKitWebViewBase used to display the inspector. 

unstable since: 4.1 

webkit_web_inspector_is_attached 

Whether the inspector view is currently attached to the same window that contains the inspected view. 
unstable since: 4.1 

webkit_web_inspector_show 

Request inspector to be shown. 

unstable since: 4.1 


Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.WebInspector:attached-height 


The height that the inspector view should have when it is attached. 
unstable since: 4.1 
Whether the inspector can be attached to the same window that contains the inspected view. 


since: 2.8 


WebKit2.WebInspector:inspected-uri 


The URI that is currently being inspected. 


unstable since: 4.1 


Signals 
WebKit2.WebInspector::attach 


Emitted when the inspector is requested to be attached to the window where the inspected web view is. If 
this signal is not handled the inspector view will be automatically attached to the inspected view, so you 
only need to handle this signal if you want to attach the inspector view yourself (for example, to add the 
inspector view to a browser tab). 


unstable since: 4.1 


WebKit2.WebInspector::bring-to-front 


Emitted when the inspector should be shown. 


unstable since: 4.1 


WebKit2.WebInspector::closed 


Emitted when the inspector page is closed. If you are using your own inspector window, you should 
connect to this signal and destroy your window. 


unstable since: 4.1 


WebKit2.WebInspector::detach 


Emitted when the inspector is requested to be detached from the window it is currently attached to. The 
inspector is detached when the inspector page is about to be closed, and this signal is emitted right before 
WebKitWebInspector: :closed, or when the user clicks on the detach button in the inspector view 
to show the inspector in a separate window. In this case the signal 

WebKitWebInspector: :open—window is emitted after this one. 


unstable since: 4.1 


WebKit2.WebInspector::open-window 


Emitted when the inspector is requested to open in a separate window. If this signal is not handled, a 

Gt kWindow with the inspector will be created and shown, so you only need to handle this signal if you 
want to use your own window. This signal is emitted after WebKitWebInspector: : detach to show 
the inspector in a separate window after being detached. 


unstable since: 4.1 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2WebInspectorClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Method 


WebKit2\WebInspectorpttach 
Declaration 


void 
webkit_web_inspector_attach ( 

WebKitWebInspector* inspector 
) 


Description 


Request inspector to be attached. 


The signal WebKitWebInspector::attach will be emitted. If the inspector is already attached it 
does nothing. 
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Methods 
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Method 


WebKit2WebInspectortlose 
Declaration 


void 

webkit_web_inspector_close ( 
WebKitWebInspector* inspector 

) 


Description 


Request inspector to be closed. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 

WebInspector 

Methods 

get_attached_height]get_can_attach is_attached 
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Method 


WebKit2WebInspectordetach 
Declaration 


void 
webkit_web_inspector_detach ( 

WebKitWebInspector* inspector 
) 


Description 


Request inspector to be detached. 


The signal WebKitWebInspector: :detach will be emitted. If the inspector is already detached it 
does nothing. 
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Library Version: 2.42.4 


Type 

WebInspector 

Methods 
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Method 


WebKit | ebInspectorget_attached_height 
Declaration 


guint 

webkit_web_inspector_get_attached_height ( 
WebKitWebInspector* inspector 

) 


Description 


Get the height that the inspector view when attached. 


Get the height that the inspector view should have when it’s attached. If the inspector view is not attached 
this returns 0. 


Gets property |WebKit2.WebInspector:attached-height 


Return value 
Type: guint 


The height of the inspector view when attached. 


| 


WebKit2 
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Type 

WebInspector 

Methods 

get_attached_height]get_can_attach is_attached 
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Method 


WebKit J ebInspectorget_can_attach 


since: 2.8 


Declaration 


gboolean 
webkit_web_inspector_get_can_attach ( 
WebKitWebInspector* inspector 


) 


Description 


Whether the inspector can be attached to the same window that contains the inspected view. 


Available since: 2.8 


Gets property |WebKit2.WebInspector:can-attach 


Return value 
Type: gboolean 


TRUE if there is enough room for the inspector view inside the window that contains the inspected view, 
or FALSE otherwise. 
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Type 

WebInspector 

Methods 

get_attached_height]get_can_attach is_attached 
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Method 


WebKit2\WebInspectorget_inspected_uri 
Declaration 


const char* 

webkit_web_inspector_get_inspected_uri ( 
WebKitWebInspector* inspector 

) 


Description 


Get the URI that is currently being inspected. 


This can be NULL if nothing has been loaded yet in the inspected view, if the inspector has been closed or 
when inspected view was loaded from a HTML string instead of a URI. 


Gets property |WebKit2.WebInspector:inspected-uri 


Return value 
Type: const char* 


The URI that is currently being inspected or NULL. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 
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WebInspector 

Methods 
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Method 


WebKit | ebInspectorget_web_view 
Declaration 


WebKitWebViewBase* 

webkit_web_inspector_get_web_view ( 
WebKitWebInspector* inspector 

) 


Description 


Get the WebKitWebViewBase used to display the inspector. 


This might be NULL if the inspector hasn’t been loaded yet, or it has been closed. 


Return value 


Type: |WebKitWebViewBase 


The WebKitWebViewBase used to display the inspector or NULL. 


The data is owned by the instance. 
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Library Version: 2.42.4 
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Method 


WebKit | ebInspectoris_attached 
Declaration 


gboolean 

webkit_web_inspector_is_attached ( 
WebKitWebInspector* inspector 

) 


Description 


Whether the inspector view is currently attached to the same window that contains the inspected view. 
Return value 
Type: gboolean 


TRUE if inspector is currently attached or FALSE otherwise. 
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Method 


WebKit2\WebInspectorshow 
Declaration 


void 

webkit_web_inspector_show ( 
WebKitWebInspector* inspector 

) 


Description 


Request inspector to be shown. 
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Property 


WebKit2WebInspectortattached-height 


unstable since: 4.1 


Declaration 


property attached-height: guint [ read ] 


Description 


The height that the inspector view should have when it is attached. 


Type: guint 


Available since: 4.1 


Default value 0 


Getter method |webkit_web_inspector_get_attached_height () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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Property 
WebKit2\WebInspectortcan-attach 
since: 2.8 

Declaration 

property can-attach: gboolean [ read ] 


Description 


Whether the inspector can be attached to the same window that contains the inspected view. 


Type: gboolean 


Available since: 2.8 


Default value FALSE 


Getter method |webkit_web_inspector_get_can_attach () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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Property 


WebKit2\WebInspectortinspected-uri 


unstable since: 4.1 


Declaration 


property inspected-uri: utf8 [ read ] 


Description 


The URI that is currently being inspected. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_web_inspector_get_inspected_uri () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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Signal 


WebKit2\WebInspectort:attach 


unstable since: 4.1 


Declaration 


gboolean 

attach ( 
WebKitWebInspector* self, 
gpointer user_data 

) 


Description 


Emitted when the inspector is requested to be attached to the window where the inspected web view is. If 
this signal is not handled the inspector view will be automatically attached to the inspected view, so you 
only need to handle this signal if you want to attach the inspector view yourself (for example, to add the 
inspector view to a browser tab). 


To prevent the inspector view from being attached you can connect to this signal and simply return TRUE. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 
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Library Version: 2.42.4 
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Signals 
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Signal 


WebKit2\WebInspectort:bring-to-front 


unstable since: 4.1 


Declaration 


gboolean 

bring_to_front ( 
WebKitWebInspector* self, 
gpointer user_data 

) 


Description 


Emitted when the inspector should be shown. 


If the inspector is not attached the inspector window should be shown on top of any other windows. If the 
inspector is attached the inspector view should be made visible. For example, if the inspector view is 
attached using a tab in a browser window, the browser window should be raised and the tab containing the 
inspector view should be the active one. In both cases, if this signal is not handled, the default 
implementation calls gtk_window_present () on the current toplevel Gt kWindow of the 

inspector view. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 
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Library Version: 2.42.4 
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Signals 
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Signal 


WebKit2\WebInspectort:closed 


unstable since: 4.1 


Declaration 


void 

closed ( 
WebKitWebInspector* self, 
gpointer user_data 


) 


Description 


Emitted when the inspector page is closed. If you are using your own inspector window, you should 
connect to this signal and destroy your window. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 
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Signal 


WebKit2\WebInspectort:detach 


unstable since: 4.1 


Declaration 


gboolean 

detach ( 
WebKitWebInspector* self, 
gpointer user_data 

) 


Description 


Emitted when the inspector is requested to be detached from the window it is currently attached to. The 
inspector is detached when the inspector page is about to be closed, and this signal is emitted right before 
WebKitWebInspector: : closed, or when the user clicks on the detach button in the inspector view 
to show the inspector in a separate window. In this case the signal 

WebKitWebInspector: :open—window is emitted after this one. 


To prevent the inspector view from being detached you can connect to this signal and simply return TRUE. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 
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Signal 


WebKit2\WebInspectort:open-window 


unstable since: 4.1 


Declaration 


gboolean 

open_window ( 
WebKitWebInspector* self, 
gpointer user_data 

) 


Description 


Emitted when the inspector is requested to open in a separate window. If this signal is not handled, a 
GtkWindow with the inspector will be created and shown, so you only need to handle this signal if you 
want to use your own window. This signal is emitted after WebKitWebInspector: :detach to show 
the inspector in a separate window after being detached. 


To prevent the inspector from being shown you can connect to this signal and simply return TRUE. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 
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Class 


WebKit2|WebResource 


unstable since: 4.1 


Description 


class WebKit2.WebResource : GObject.Object 
{ 

priv: WebKitWebResourcePrivate* 
} 


Represents a resource at the end of a URI. 


A WebKitWebResource encapsulates content for each resource at the end of a particular URI. For 
example, one WebKitWebResource will be created for each separate image and stylesheet when a page 
is loaded. 


You can access the response and the URI for a given WebKitWebResource, using 
webkit_web_resource_get_uri() and webkit_web_resource_get_response(), as well as the raw 
data, using webkit_web_resource_get_data(). 


Available since: 4.1 


Hierarchy 
hierarchy this WebKitWebResource ancestor_0 GObject ancestor_0--this 
Ancestors 

@ GObject 


Instance methods 


webkit_web_resource_get_data 

Asynchronously get the raw data for resource. 

unstable since: 4.1 

webkit_web_resource_get_data_finish 

Finish an asynchronous operation started with webkit_web_resource_get_data(). 
unstable since: 4.1 

webkit_web_resource_get_response 

Retrieves the WebKit URIResponse of the resource load operation. 
unstable since: 4.1 

webkit_web_resource_get_uri 

Returns the current active URI of resource. 

unstable since: 4.1 


Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.WebResource:response 


The WebKitURIResponse associated with this resource. 


unstable since: 4.1 


WebKit2.WebResource:uri 


The current active URI of the WebKitWebResource. See webkit_web_resource_get_uri () 
for more details. 


unstable since: 4.1 


Signals 
WebKit2.WebResource::failed 


This signal is emitted when an error occurs during the resource load operation. 


unstable since: 4.1 


WebKit2.WebResource::failed-with-tls-errors 


This signal is emitted when a TLS error occurs during the resource load operation. 


since: 2.8 


WebKit2.WebResource::finished 


This signal is emitted when the resource load finishes successfully or due to an error. In case of errors 
WebKitWebResource: : failed signal is emitted before this one. 


unstable since: 4.1 


WebKit2.WebResource::received-data 


This signal is emitted after response is received, every time new data has been received. It’s useful to 
know the progress of the resource load operation. 


unstable deprecated: 2.40 since: 4.1 


WebKit2.WebResource::sent-request 


This signal is emitted when request has been sent to the server. In case of a server redirection this 
signal is emitted again with the request argument containing the new request sent to the server due to 
the redirection and the redirected_response parameter containing the response received by the 
server for the initial request. 


unstable since: 4.1 


Signals inherited from GObject (1) 


GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2WebResourceClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Method 


WebKit3WebResourceget_data 
Declaration 


void 

webkit_web_resource_get_data ( 
WebKitWebResource* resource, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


) 


Description 


Asynchronously get the raw data for resource. 


When the operation is finished, callback will be called. You can then call 
webkit_web_resource_get_data_finish () to get the result of the operation. 


Parameters 
cancellable 


Type: GCancellable 


A GCancellable or NULL to ignore. 
The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2WebResourceget_data_finish 
Declaration 


guchar* 
webkit_web_resource_get_data_finish ( 
WebKitWebResource* resource, 
GAsyncResult* result, 
gsize* length, 
GError** error 


Description 


Finish an asynchronous operation started with webkit_web_resource_get_data(). 
Parameters 
result 

Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


length 
Type: gsize* 
Return location for the length of the resource data. 


The argument will be set by the function. 


The argument can be NULL. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 

Return value 

Type: An array of guint 8 


A string with the data of resource, or NULL in case of error. if length is not NULL, the size of the 
data will be assigned to it. 


The length of the array is in the length argument. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit | ebResourceget_response 
Declaration 


WebKitURIResponse* 
webkit_web_resource_get_response ( 
WebKitWebResource* resource 


) 


Description 


Retrieves the WebKit URIResponse of the resource load operation. 


This method returns NULL if called before the response is received from the server. You can connect to 
notify::response signal to be notified when the response is received. 


Gets property |WebKit2.WebResource: response 


Return value 


Type: |WebKitURIResponse 


The WebKitURIResponse, or NULL if the response hasn’t been received yet. 


The data is owned by the instance. 
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Methods 
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Method 


WebKit2WebResourceget_uri 
Declaration 


const gchar* 
webkit_web_resource_get_uri ( 
WebKitWebResource* resource 


) 


Description 


Returns the current active URI of resource. 
The active URI might change during a load operation: 


When the resource load starts, the active URI is the requested URI When the initial request is sent to the 
server, WebKitWebResource: :sent—request signal is emitted without a redirected response, the 
active URI is the URI of the request sent to the server. In case of a server redirection, 
WebKitWebResource: :sent—request signal is emitted again with a redirected response, the 
active URI is the URI the request was redirected to. When the response is received from the server, the 
active URI is the final one and it will not change again. 


You can monitor the active URI by connecting to the notify::uri signal of resource. 


Gets property |WebKit2.WebResource:uri 


Return value 
Type: const gchar* 
The current active URI of resource. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Property 


WebKit2\WebResourcetresponse 


unstable since: 4.1 


Declaration 


property response: WebKit2.URIResponse [ read ] 


Description 


The WebKitURIResponse associated with this resource. 


Type: WebKitURIResponse 


Available since: 4.1 


Getter method |webkit_web_resource_get_response() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
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Properties 
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Property 


WebKit{WebResourcezuri 


unstable since: 4.1 


Declaration 


property uri: utf8 [ read ] 


Description 


The current active URI of the WebKitWebResource. See webkit_web_resource_get_uri () 
for more details. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_web_resource_get_uri () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 
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Signal 


WebKit2|WebResource}:failed 


unstable since: 4.1 


Declaration 


void 

failed ( 
WebKitWebResource* self, 
GError* error, 
gpointer user_data 


) 


Description 


This signal is emitted when an error occurs during the resource load operation. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 
error 
Type: GError 


The GError that was triggered. 


The data is owned by the caller of the function. 
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Signal 


WebKit2WebResourcet :failed-with-tls-errors 


since: 2.8 


Declaration 


void 

failed_with_tls_errors ( 
WebKitWebResource* self, 
GTlsCertificate* certificate, 
GTlsCertificateFlags errors, 
gpointer user_data 


) 


Description 


This signal is emitted when a TLS error occurs during the resource load operation. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.8 


Parameters 
certificate 
Type: GTlsCertificate 


AGTlsCertificate. 


The data is owned by the caller of the function. 


errors 
Type: GTlsCertificateFlags 


A GTlsCertificateFlags with the verification status of certificate. 
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Signal 


WebKit2WebResourcet :finished 


unstable since: 4.1 


Declaration 


void 

finished ( 
WebKitWebResource* self, 
gpointer user_data 

) 


Description 


This signal is emitted when the resource load finishes successfully or due to an error. In case of errors 
WebKitWebResource: : failed signal is emitted before this one. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 
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Signals 
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Generated by[gi-docgen]2023.3 


Signal 


WebKit2WebResourcet:received-data 


unstable deprecated: 2.40 since: 4.1 


Declaration 


void 

received_data ( 
WebKitWebResource* self, 
guint64 data_length, 
gpointer user_data 


) 


Description 


This signal is emitted after response is received, every time new data has been received. It’s useful to 
know the progress of the resource load operation. 


This is signal is deprecated since version 2.40 and it’s never emitted. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 
Available since: 4.1 
Deprecated since: 2.40 


Please do not use it in newly written code. 


Parameters 
data_length 
Type: guint 64 


The length of data received in bytes. 
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Signal 


WebKit2WebResourcet:sent-request 


unstable since: 4.1 


Declaration 


void 

sent_request ( 
WebKitWebResource* self, 
WebKitURIRequest* request, 
WebKitURIResponse* redirected_response, 
gpointer user_data 


) 


Description 


This signal is emitted when request has been sent to the server. In case of a server redirection this 
signal is emitted again with the request argument containing the new request sent to the server due to 
the redirection and the redirected_response parameter containing the response received by the 
server for the initial request. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


request 


Type: |WebKitURIRequest 


A WebKitURIRequest. 


The data is owned by the caller of the function. 


redirected_response 


Type:|WebKitURIResponse 


A WebKitURIResponse, or NULL. 


The data is owned by the caller of the function. 
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Class 


WebKit2/WebsiteDataAccessPermissionRequest 


since: 2.30 


Description 


class WebKit2.WebsiteDataAccessPermissionRequest : GObject.Object 
implements WebKit2.PermissionRequest { 
priv: WebKitWebsiteDataAccessPermissionRequestPrivate* 

} 

A permission request for accessing website data from third-party domains. 


WebKitWebsiteDataAccessPermissionRequest represents a request for permission to allow a third-party 
domain access its cookies. 


When a WebKitWebsiteDataAccessPermissionRequest is not handled by the user, it is denied by default. 
Available since: 2.30 


Hierarchy 
hierarchy this WebKitWebsiteDataAccessPermissionRequest implements_O|WebKitPermissionRequest 


this--implements_0 ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Implements 


@ |WebKitPermissionRequest! 


Instance methods 


webkit_website_data_access_permission_request_get_current_domain 


Get the current domain being browsed. 


since: 2.30 


webkit_website_data_access_permission_request_get_requesting_domain| 


Get the domain requesting permission to access its cookies while browsing the current domain. 
since: 2.30 

Methods inherited from GObject (43) 

Please see GObject for a full list of methods. 


Methods inherited from|WebKitPermissionRequest| (2) 
webkit_permission_request_allow 


Allow the action which triggered this request. 
unstable since: 4.1 
Deny the action which triggered this request. 


unstable since: 4.1 


Signals 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2WebsiteDataAccessPermissionRequestClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Method 


WebKit2WebsiteDataA ccessPermissionRequestget_current_domain 


since: 2.30 


Declaration 


const char* 
webkit_website_data_access_permission_request_get_current_domain ( 


WebKitWebsiteDataAccessPermissionRequest* request 


) 


Description 


Get the current domain being browsed. 
Available since: 2.30 

Return value 

Type: const char* 

The current domain name. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Type 
'WebsiteDataAccessPermissionRequest 


Methods 
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Method 


IW ebKit2WebsiteDataAccessPermissionRequestbet_requesting_domain 


since: 2.30 


Declaration 


const char* 
webkit_website_data_access_permission_request_get_requesting_domain ( 
WebKitWebsiteDataAccessPermissionRequest* request 


) 


Description 


Get the domain requesting permission to access its cookies while browsing the current domain. 
Available since: 2.30 

Return value 

Type: const char* 

The requesting domain name. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Website DataManager 


Constructors 


new|new_ephemeral 


Functions 


Instance methods 


get_service_worker_registrations_director 


Properties 


base-cache-directory|base-data-directory|disk-cache-directory|dom-cache-directory}hsts-cache-director 
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Class 


WebKit2WebsiteDataManager 


since: 2.10 


Description 


class WebKit2.WebsiteDataManager : GObject.Object 
{ 
priv: WebKitWebsiteDataManagerPrivate* 


} 
Manages data stored locally by web sites. 


You can use WebKitWebsiteDataManager to configure the local directories where website data will be 
stored. Use WebKitWebsiteDataManager:base-data-directory and 
WebKitWebsiteDataManager:base-cache-directory set a common base directory for all 
website data and caches. 


A WebKitWebsiteDataManager can be ephemeral, in which case all the directory configuration is not 
needed because website data will never persist. You can create an ephemeral 
WebKitWebsiteDataManager with webkit_website_data_manager_new_ephemeral(). 


WebKitWebsiteDataManager can also be used to fetch website data, remove data stored by particular 
websites, or clear data for all websites modified since a given period of time. 


Available since: 2.10 


Hierarchy 


hierarchy this WebKitWebsiteDataManager ancestor_0 GObject ancestor_0--this 


Ancestors 


@ GObject 


Constructors 


webkit_website_data_manager_new 


Creates anew WebKitWebsiteDataManager with the given options. 
since: 2.10 
Creates an ephemeral WebKitWebsiteDataManager. 


since: 2.16 


Functions 


webkit_website_data_manager_set_memory_pressure_settings 


Sets settings as the WebKitMemoryPressureSettings. 


since: 2.34 


Instance methods 


webkit_website_data_manager_clear 


Asynchronously clear the website data of the given types modified in the past timespan. 


since: 2.16 


webkit_website_data_manager_clear_finish 


Finish an asynchronous operation started with webkit_website_data_manager_clear () 
since: 2.16 
Asynchronously get the list of WebKitWebsiteData for the given types. 


since: 2.16 


webkit_website_data_manager_fetch_finish 


Finish an asynchronous operation started with webkit_website_data_manager_fetch(). 


since: 2.16 


webkit_website_data_manager_get_base_cache_directory, 


Get the WebKitWebsiteDataManager:base-cache-directory property. 


since: 2.10 


webkit_website_data_manager_get_base_data_directory 


Get the WebKitWebsiteDataManager:base-data-—directory property. 


since: 2.10 


webkit_website_data_manager_get_cookie_manager 


Get the WebKitCookieManager of manager. 


since: 2.16 


webkit_website_data_manager_get_disk_cache_directory 


Get the WebKitWebsiteDataManager:disk-cache-directory property. 


deprecated: 2.40 since: 2.10 


webkit_website_data_manager_get_dom_cache_directory, 


Get the WebKitWebsiteDataManager:dom-cache-directory property. 


deprecated: 2.40 since: 2.30 


webkit_website_data_manager_get_hsts_cache_directory 


Get the WebKitWebsiteDataManager:hsts-—cache-directory property. 


deprecated: 2.40 since: 2.26 


webkit_website_data_manager_get_indexeddb_directory 


Get the WebKitWebsiteDataManager:indexeddb-directory property. 


deprecated: 2.40 since: 2.10 


webkit_website_data_manager_get_itp_directory 


Get the WebKitWebsiteDataManager:itp-directory property. 
deprecated: 2.40 since: 2.30 
Get whether Intelligent Tracking Prevention (ITP) is enabled or not. 


since: 2.30 


webkit_website_data_manager_get_itp_summary 


Asynchronously get the list of WebKit ITPThirdParty seen for manager. 


since: 2.30 


webkit_website_data_manager_get_itp_summary_finish 


Finish an asynchronous operation started with webkit_website_data_manager_get_itp_summary(). 


since: 2.30 


webkit_website_data_manager_get_local_storage_directory 


Get the WebKitWebsiteDataManager:local-storage-directory property. 


deprecated: 2.40 since: 2.10 


webkit_website_data_manager_get_offline_application_cache_directory 


Get the WebKitWebsiteDataManager:offline-application-cache-directory 
property. 


deprecated: 2.40 since: 2.10 


webkit_website_data_manager_get_persistent_credential_storage_enabled 


Get whether persistent credential storage is enabled or not. 


since: 2.30 


webkit_website_data_manager_get_service_worker_registrations_directory 


Get the WebKitWebsiteDataManager:service-worker-registrations-—directory 
property. 


deprecated: 2.40 since: 2.30 


webkit_website_data_manager_get_tls_errors_policy 


Get the TLS errors policy of manager. 


since: 2.32 


webkit_website_data_manager_get_websql_directory 


Get the WebKitWebsiteDataManager:websql-directory property. 


deprecated: 2.24. since: 2.10 


webkit_website_data_manager_is_ephemeral 


Get whether a WebKitWebsiteDataManager is ephemeral. 


since: 2.16 


webkit_website_data_manager_remove 


Asynchronously removes the website data in the given website_data list. 


since: 2.16 


webkit_website_data_manager_remove_finish 


Finish an asynchronous operation started with webkit_website_data_manager_remove(). 


since: 2.16 


webkit_website_data_manager_set_itp_enabled 


Enable or disable Intelligent Tracking Prevention (ITP). 


since: 2.30 


webkit_website_data_manager_set_network_proxy_settings 


Set the network proxy settings to be used by connections started in manager session. 


since: 2.32 


webkit_website_data_manager_set_persistent_credential_storage_enabled 


Enable or disable persistent credential storage. 


since: 2.30 


webkit_website_data_manager_set_tls_errors_policy 


Set the TLS errors policy of manager as policy. 
since: 2.32 
Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.WebsiteDataManager:base-cache-directory 


The base directory for caches. If NULL, a default location will be used. 


since: 2.10 


WebKit2.WebsiteDataManager:base-data-directory 


The base directory for website data. If NULL, a default location will be used. 


since: 2.10 


WebKit2.WebsiteDataManager:disk-cache-directory 


The directory where HTTP disk cache will be stored. 
deprecated: 2.40. since: 2.10 

[WebKit2. WebsiteDataManager:dom-cache-directory] 
The directory where DOM cache will be stored. 


deprecated: 2.40. since: 2.30 


WebKit2.WebsiteDataManager:hsts-cache-directory 


The directory where the HTTP Strict-Transport-Security (HSTS) cache will be stored. 


deprecated: 2.40. since: 2.26 


WebKit2.WebsiteDataManager:indexeddb-directory 


The directory where IndexedDB databases will be stored. 


deprecated: 2.40. since: 2.10 


WebKit2.WebsiteDataManager:is-ephemeral 


Whether the WebKitWebsiteDataManager is ephemeral. An ephemeral 
WebKitWebsiteDataManager handles all websites data as non-persistent, and nothing will be 
written to the client storage. Note that if you create an ephemeral WebKitWebsiteDataManager all 
other construction parameters to configure data directories will be ignored. 


since: 2.16 
WebKit2.WebsiteDataManager:itp-directory 
The directory where Intelligent Tracking Prevention (ITP) data will be stored. 


deprecated: 2.40. since: 2.30 


WebKit2.WebsiteDataManager:local-storage-directory, 


The directory where local storage data will be stored. 


deprecated: 2.40. since: 2.10 


WebKit2.WebsiteDataManager: offline-application-cache-directory 


The directory where offline web application cache will be stored. 


deprecated: 2.40. since: 2.10 


WebKit2.WebsiteDataManager:origin-storage-ratio 


The percentage of volume space that can be used for data storage for every domain. If the maximum 
storage is reached the storage request will fail with a QuotaExceededError exception. A value of 0.0 
means that data storage is not allowed. A value of -1.0, which is the default, means WebKit will use the 
default quota (1 GiB). 


since: 2.42 


WebKit2.WebsiteDataManager:service-worker-registrations-directory 


The directory where service workers registrations will be stored. 
deprecated: 2.40. since: 2.30 


WebKit2.WebsiteDataManager:total-storage-ratio 


The percentage of volume space that can be used for data storage for all domains. If the maximum storage 
is reached the eviction will happen. A value of 0.0 means that data storage is not allowed. A value of -1.0, 
which is the default, means there’s no limit for the total storage. 


since: 2.42 

The directory where WebSQL databases will be stored. 
deprecated: 2.24. since: 2.10 

Signals 

Signals inherited from GObject (1) 


GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2WebsiteDataManagerClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 


Content 


Description 
Hierarch 


onstructors 


TH [O]| > 
5 
a) 
o 
4 
io) 
wa 


unctions 
ethods 
roperties 


eoeeovece 
= 


: 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Website DataManager 


Constructors 


new 
Generated by[gi-docgen|2023.3 


Constructor 
WebKit2WebsiteDataManagernew 
since: 2.10 


Declaration 


WebKitWebsiteDataManager* 
webkit_website_data_manager_new ( 


const gchar* first_option_name, 


Description 


Creates anew WebKitWebsiteDataManager with the given options. 
It must be passed as construction parameter of aWebKitWebContext. 
Available since: 2.10 


This method is not directly available to language bindings. 


Parameters 
first_option_name 
Type: const gchar* 


Name of the first option to set. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


Type: 


Value of first option, followed by more options, NULL-terminated. 


Return value 


Type: |WebKitWebsiteDataManager 


The newly created WebKitWebsiteDataManager. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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Constructor 
WebKit J ebsiteDataManagernew_ephemeral 
since: 2.16 


Declaration 


WebKitWebsiteDataManager* 
webkit_website_data_manager_new_ephemeral ( 
void 


) 


Description 


Creates an ephemeral WebKitWebsiteDataManager. 


See WebKitWebsiteDataManager:is—ephemeral for more details. 


Available since: 2.16 


Return value 


Type: |WebKitWebsiteDataManager 


A new ephemeral WebKitWebsiteDataManager. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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Function 


WebKit2|WebsiteDataManagerset_memory_pressure_settings 


since: 2.34 


Declaration 


void 
webkit_website_data_manager_set_memory_pressure_settings ( 
WebKitMemoryPressureSettings* settings 


) 


Description 


Sets settings as the WebKitMemoryPressureSettings. 


Sets settings as the WebKitMemoryPressureSettings to be used by all the network processes 
created by any instance of WebKitWebsiteDataManager after this function is called. 


Be sure to call this function before creating any WebKitWebsiteDataManager, as network processes 
of existing instances are not guaranteed to receive the passed settings. 


The periodic check for used memory is disabled by default on network processes. This will be enabled 
only if custom settings have been set using this function. After that, in order to remove the custom settings 
and disable the periodic check, this function must be called passing NULL as the value of settings. 


Available since: 2.34 


Parameters 


settings 


Type:|(WebKitMemoryPressureSettings 


A WebKitMemoryPressureSettings. 


The data is owned by the caller of the function. 
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Method 


WebKit2WebsiteDataManagertlear 


since: 2.16 


Declaration 


void 

webkit_website_data_manager_clear ( 
WebKitWebsiteDataManager* manager, 
WebKitWebsiteDataTypes types, 
GTimeSpan timespan, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously clear the website data of the given types modified in the past timespan. 


If timespan is 0, all website data will be removed. 


When the operation is finished, callback will be called. You can then call 
webkit_website_data_manager_clear_finish() to get the result of the operation. 


Due to implementation limitations, this function does not currently delete any stored cookies if 
timespan is nonzero. This behavior may change in the future. 


Available since: 2.16 
Parameters 
types 


Type:\WebKitWebsiteDataTypes 


WebKitWebsiteDataTypes. 


timespan 
Type: GTimeSpan 


A GTimeSpan. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2WebsiteDataManagertlear_finish 


since: 2.16 


Declaration 


gboolean 
webkit_website_data_manager_clear_finish ( 
WebKitWebsiteDataManager* manager, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_website_data_manager_clear () 


Available since: 2.16 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error| 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 

Return value 

Type: gboolean 


TRUE if website data was successfully cleared, or FALSE otherwise. 
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Method 


WebKit2\WebsiteDataManagerfetch 


since: 2.16 


Declaration 


void 

webkit_website_data_manager_fetch ( 
WebKitWebsiteDataManager* manager, 
WebKitWebsiteDataTypes types, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously get the list of WebKitWebsiteData for the given types. 


When the operation is finished, callback will be called. You can then call 
webkit_website_data_manager_fetch_finish () to get the result of the operation. 


Available since: 2.16 
Parameters 
types 


Type:\WebKitWebsiteDataTypes 


WebKitWebsiteDataTypes. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Methods 


get_persistent_credential_storage_enabled 


Generated by[gi-docgen]2023.3 
Method 


WebKit2WebsiteDataManagerfetch_finish 


since: 2.16 


Declaration 


GList* 
webkit_website_data_manager_fetch_finish ( 
WebKitWebsiteDataManager* manager, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_website_data_manager_fetch(). 


Available since: 2.16 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error| 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 

Return value 

Type: A list of WebKitWebsiteData* 


AGList of WebKitWebsiteData. You must free the GList with g_list_free() and unref the 
WebKitWebsiteDatas with webkit_website_data_unref () when you’re done with them. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 
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Generated by[gi-docgen]2023.3 


Method 
WebKit J ebsiteDataManagerget_base_cache_directory 
since: 2.10 


Declaration 


const gchar* 
webkit_website_data_manager_get_base_cache_directory ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get the WebKitWebsiteDataManager:base-cache-directory property. 


Available since: 2.10 


Gets property |WebKit2.WebsiteDataManager:base-cache-directory 


Return value 
Type: const gchar* 


The base directory for caches, or NULL if 


WebKitWebsiteDataManager:base-cache-directory was not provided or manager 
is ephemeral. 


The data is owned by the instance. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Methods 
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Method 
WebKit J ebsiteDataManagerget_base_data_directory 
since: 2.10 


Declaration 


const gchar* 
webkit_website_data_manager_get_base_data_directory ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get the WebKitWebsiteDataManager:base-data-directory property. 


Available since: 2.10 


Gets property |WebKit2.WebsiteDataManager:base-—data-—directory 


Return value 
Type: const gchar* 


The base directory for website data, or NULL if 
WebKitWebsiteDataManager:base-data-directory was not provided or manager 
is ephemeral. 


The data is owned by the instance. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Methods 
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Method 
WebKit J ebsiteDataManagerget_cookie_manager 
since: 2.16 


Declaration 


WebKitCookieManager* 
webkit_website_data_manager_get_cookie_manager ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get the WebKitCookieManager of manager. 


Available since: 2.16 


Return value 


Type: |WebKitCookieManager 


A WebKitCookieManager. 


The data is owned by the instance. 


| 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Methods 


Generated by[gi-docgen]2023.3 
Method 


WebKit2\WebsiteDataManagerpget_disk_cache_directory 


deprecated: 2.40 since: 2.10 


Declaration 


const gchar* 
webkit_website_data_manager_get_disk_cache_directory ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get the WebKitWebsiteDataManager:disk-cache-directory property. 
Available since: 2.10 


Deprecated since: 2.40 


, use webkit_website_data_manager_get_base_cache_directory () instead. 


Gets property |WebKit2.WebsiteDataManager:disk—-cache-directory 


Return value 

Type: const gchar* 

The directory where HTTP disk cache is stored or NULL if manager is ephemeral. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Methods 
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Method 


WebKit J ebsiteDataManagerget_dom_cache_directory 


deprecated: 2.40 since: 2.30 


Declaration 


const gchar* 
webkit_website_data_manager_get_dom_cache_directory ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get the WebKitWebsiteDataManager:dom-cache-directory property. 
Available since: 2.30 


Deprecated since: 2.40 


, use webkit_website_data_manager_get_base_cache_directory () instead. 


Gets property |WebKit2.WebsiteDataManager:dom-cache-directory 


Return value 

Type: const gchar* 

The directory where DOM cache is stored or NULL if manager is ephemeral. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Methods 
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Method 


WebKit J ebsiteDataManagerget_hsts_cache_directory 


deprecated: 2.40 since: 2.26 


Declaration 


const gchar* 
webkit_website_data_manager_get_hsts_cache_directory ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get the WebKitWebsiteDataManager:hsts-—cache-directory property. 
Available since: 2.26 


Deprecated since: 2.40 


, use webkit_website_data_manager_get_base_cache_directory () instead. 


Gets property |WebKit2.WebsiteDataManager:hsts-—cache-directory 


Return value 

Type: const gchar* 

The directory where the HSTS cache is stored or NULL if manager is ephemeral. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit J ebsiteDataManagerpget_indexeddb_directory 


deprecated: 2.40 since: 2.10 


Declaration 


const gchar* 
webkit_website_data_manager_get_indexeddb_directory ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get the WebKitWebsiteDataManager:indexeddb-directory property. 
Available since: 2.10 


Deprecated since: 2.40 


, use webkit_website_data_manager_get_base_data_directory () instead. 


Gets property |WebKit2.WebsiteDataManager: indexeddb-directory 


Return value 

Type: const gchar* 

The directory where IndexedDB databases are stored or NULL if manager is ephemeral. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Methods 


Generated by[gi-docgen]2023.3 
Method 


WebKit2WebsiteDataManagerget_itp_directory 


deprecated: 2.40 since: 2.30 


Declaration 


const gchar* 
webkit_website_data_manager_get_itp_directory ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get the WebKitWebsiteDataManager:itp-directory property. 
Available since: 2.30 


Deprecated since: 2.40 


, use webkit_website_data_manager_get_base_data_directory () instead. 


Gets property |WebKit2.WebsiteDataManager:itp-directory 


Return value 

Type: const gchar* 

The directory where Intelligent Tracking Prevention data is stored or NULL if manager is ephemeral. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Methods 
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Method 


WebKit J ebsiteDataManagereet_itp_enabled 


since: 2.30 


Declaration 


gboolean 
webkit_website_data_manager_get_itp_enabled ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get whether Intelligent Tracking Prevention (ITP) is enabled or not. 


Available since: 2.30 


Return value 
Type: gboolean 


TRUE if ITP is enabled, or FALSE otherwise. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Methods 
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Method 


WebKit2WebsiteDataManagerget_itp_summary 


since: 2.30 


Declaration 


void 
webkit_website_data_manager_get_itp_summary ( 
WebKitWebsiteDataManager* manager, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


) 


Description 


Asynchronously get the list of WebKit ITPThirdParty seen for manager. 


Every WebKit ITPThirdParty contains the list of WebKit ITPFirstParty under which it has 
been seen. 


When the operation is finished, callback will be called. You can then call 
webkit_website_data_manager_get_itp_summary_finish() to get the result of 
the operation. 


Available since: 2.30 
Parameters 
cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 
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Method 


WebKit2WebsiteDataManagerpet_itp_summary_finish 


since: 2.30 


Declaration 


GList* 
webkit_website_data_manager_get_itp_summary_finish ( 
WebKitWebsiteDataManager* manager, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_website_data_manager_get_itp_summary(). 


Available since: 2.30 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error| 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 
In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 
Return value 
Type: A list of WebKit ITPThirdParty* 
A GList of WebKitITPThirdParty. You must free the GList with g_list_free() and unref 


the WebKit ITPThirdPartys with webkit_itp_third_party_unref () when you’re done 
with them. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 
Methods 
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Method 


WebKit | ebsiteDataManagereget_local_storage_directory 


deprecated: 2.40 since: 2.10 


Declaration 


const gchar* 

webkit_website_data_manager_get_local_storage_directory ( 
WebKitWebsiteDataManager* manager 

) 


Description 


Get the WebKitWebsiteDataManager:local-storage-directory property. 
Available since: 2.10 


Deprecated since: 2.40 


, use webkit_website_data_manager_get_base_data_directory () instead. 


Gets property |WebKit2.WebsiteDataManager:local-storage-directory 


Return value 

Type: const gchar* 

The directory where local storage data is stored or NULL if manager is ephemeral. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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Website DataManager 
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Method 


WebKit2WebsiteDataManagerget_offline_application_cache_directory 
deprecated: 2.40 since: 2.10 


Declaration 


const gchar* 

webkit_website_data_manager_get_offline_application_cache_directory ( 
WebKitWebsiteDataManager* manager 

) 


Description 


Get the WebKitWebsiteDataManager:offline-application-cache-directory 
property. 


Available since: 2.10 


Deprecated since: 2.40 


, use webkit_website_data_manager_get_base_cache_directory () instead. 


Gets 
property 


WebKit2.WebsiteDataManager:offline-application-cache-directory 


Return value 

Type: const gchar* 

The directory where offline web application cache is stored or NULL if manager is ephemeral. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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Method 

W ebKit4W ebsiteDataManagerpet_persistent_credential_storage_enabled 
since: 2.30 

Declaration 


webkit_website_data_manager_get_persistent_credential_storage_enabled ( 
WebKitWebsiteDataManager* manager 
) 


Description 


Get whether persistent credential storage is enabled or not. 
See also webkit_website_data_manager_set_persistent_credential_storage_enabled(). 


Available since: 2.30 


Return value 
Type: gboolean 


TRUE if persistent credential storage is enabled, or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 
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Method 


IW eb Kit2|W ebsiteDataManagerpet_service_worker_registrations_directory 
deprecated: 2.40 since: 2.30 


Declaration 


const gchar* 
webkit_website_data_manager_get_service_worker_registrations_directory ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get the WebKitWebsiteDataManager: service-worker-registrations-—directory 
property. 


Available since: 2.30 


Deprecated since: 2.40 


, use webkit_website_data_manager_get_base_data_directory () instead. 


Gets 
property 


WebKit2.WebsiteDataManager:service-worker—-registrations—directory 


Return value 

Type: const gchar* 

The directory where service worker registrations are stored or NULL if manager is ephemeral. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Methods 
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Method 
WebKit J ebsiteDataManagereet_tls_errors_policy 
since: 2.32 


Declaration 


WebKitTLSErrorsPolicy 
webkit_website_data_manager_get_tls_errors_policy ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get the TLS errors policy of manager. 


Available since: 2.32 


Return value 


Type: |WebKitTLSErrorsPolicy 


A WebKit TLSErrorsPolicy. 


| 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Methods 
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Method 


WebKit2\WebsiteDataManagerpget_websql_directory 


deprecated: 2.24. since: 2.10 


Declaration 


const gchar* 
webkit_website_data_manager_get_websql_directory ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get the WebKitWebsiteDataManager:websql-directory property. 


Available since: 2.10 


Deprecated since: 2.24. 


WebSQL is no longer supported. Use IndexedDB instead. 


Gets property |WebKit2.WebsiteDataManager:websgql-directory 


Return value 

Type: const gchar* 

The directory where WebSQL databases are stored or NULL if manager is ephemeral. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 
Methods 
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Method 


WebKit2WebsiteDataManageris_ephemeral 


since: 2.16 


Declaration 


gboolean 
webkit_website_data_manager_is_ephemeral ( 
WebKitWebsiteDataManager* manager 


) 


Description 


Get whether a WebKitWebsiteDataManager is ephemeral. 


See WebKitWebsiteDataManager:is—ephemeral for more details. 


Available since: 2.16 


Return value 
Type: gboolean 


TRUE if manager is ephemeral or FALSE otherwise. 
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Method 


WebKit2WebsiteDataManagerremove 


since: 2.16 


Declaration 


void 

webkit_website_data_manager_remove ( 
WebKitWebsiteDataManager* manager, 
WebKitWebsiteDataTypes types, 
GList* website_data, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously removes the website data in the given website_data list. 


Asynchronously removes the website data of the given types for websites in the given website_data 
list. Use webkit_website_data_manager_clear () if you want to remove the website data for 
all sites. 


When the operation is finished, callback will be called. You can then call 
webkit_website_data_manager_remove_finish () to get the result of the operation. 


Available since: 2.16 
Parameters 


types 


Type:|WebKitWebsiteDataTypes 


WebKitWebsiteDataTypes. 


website_data 
Type: A list of WebKitWebsiteData* 


A GList of WebKitWebsiteData. 


The data is owned by the caller of the method. 


cancellable 
Type: GCancellable 


A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Library Version: 2.42.4 
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Method 


WebKit2\WebsiteDataManagerremove_finish 


since: 2.16 


Declaration 


gboolean 
webkit_website_data_manager_remove_finish ( 
WebKitWebsiteDataManager* manager, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_website_data_manager_remove(). 


Available since: 2.16 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error| 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 

Return value 

Type: gboolean 


TRUE if website data resources were successfully removed, or FALSE otherwise. 
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API Version: 4.1 


Library Version: 2.42.4 
Type 
Website DataManager 
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Method 


WebKit2\WebsiteDataManagerset_itp_enabled 


since: 2.30 


Declaration 


void 


webkit_website_data_manager_set_itp_enabled ( 


WebKitWebsiteDataManager* manager, 
gboolean enabled 
) 


Description 


Enable or disable Intelligent Tracking Prevention (ITP). 


When ITP is enabled resource load statistics are collected and used to decide whether to allow or block 
third-party cookies and prevent user tracking. Note that while ITP is enabled the accept policy 
WEBKIT_COOKIE_POLICY_ACCEPT NO _THIRD_ PARTY is ignored and 
WEBKIT_COOKIE_POLICY_ACCEPT_ALWAYS is used instead. See 

also webkit_cookie_manager_set_accept_policy(). 


Available since: 2.30 
Parameters 
enabled 

Type: gboolean 


Value to set. 
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Type 
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Methods 
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Method 
WebKit2|WebsiteDataManagerset_network_proxy_settings 
since: 2.32 


Declaration 


void 

webkit_website_data_manager_set_network_proxy_settings ( 
WebKitWebsiteDataManager* manager, 
WebKitNetworkProxyMode proxy_mode, 
WebKitNetworkProxySettings* proxy_settings 

) 


Description 


Set the network proxy settings to be used by connections started in manager session. 


By default WEBKIT_NETWORK_PROXY_MODE_DEFAULT is used, which means that the system settings 
will be used (g_proxy_resolver_get_default()). If you want to override the system default settings, you can 
either use WEBKIT_NETWORK_PROXY_MODE_NO_PROXY to make sure no proxies are used at all, or 

WEBKIT_NETWORK_PROXY_MODE_CUSTOM to provide your own proxy settings. When proxy_mode 


is WEBKIT_NETWORK_PROXY_MODE_CUSTOM proxy_settings must be a valid 
WebKitNetworkProxySettings; otherwise, proxy_settings must be NULL. 


Available since: 2.32 


Parameters 


proxy_mode 


Type:|WebKitNetworkProxyMode 


A WebKitNetworkProxyMode. 


proxy_settings 


Type: \(WebKitNetworkProxySettings 


A WebKitNetworkProxySettings, or NULL. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 
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Method 
WebKit2|WebsiteDataManagerset_persistent_credential_storage_enabled 
since: 2.30 

Declaration 


webkit_website_data_manager_set_persistent_credential_storage_enabled ( 
WebKitWebsiteDataManager* manager, 
gboolean enabled 

) 


Description 


Enable or disable persistent credential storage. 


When enabled, which is the default for non-ephemeral sessions, the network process will try to read and 
write HTTP authentiacation credentials from persistent storage. 


Available since: 2.30 
Parameters 
enabled 

Type: gboolean 


Value to set. 
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Library Version: 2.42.4 


Type 
Website DataManager 
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Method 


WebKit J ebsiteDataManagerset_tls_errors_policy 


since: 2.32 


Declaration 


void 

webkit_website_data_manager_set_tls_errors_policy ( 
WebKitWebsiteDataManager* manager, 
WebKitTLSErrorsPolicy policy 

) 


Description 


Set the TLS errors policy of manager as policy. 


Available since: 2.32 


Parameters 
policy 


Type:|WebKitTLSErrorsPolicy 


A WebKitTLSErrorsPolicy. 
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Property 


WebKit2\WebsiteDataManagertbase-cache-directory 


since: 2.10 


Declaration 


property base-cache-directory: utf8 [ read, write, construct-only ] 


Description 


The base directory for caches. If NULL, a default location will be used. 
Type: gchar* 


Available since: 2.10 


Default value NULL 


Getter method |webkit_website_data_manager_get_base_cache_directory () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 
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Property 


WebKit2\WebsiteDataManagertbase-data-directory 


since: 2.10 


Declaration 


property base-data-directory: utf8 [ read, write, construct-only ] 


Description 


The base directory for website data. If NULL, a default location will be used. 
Type: gchar* 


Available since: 2.10 


Default value NULL 


Getter method |webkit_website_data_manager_get_base_data_directory () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 
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Library Version: 2.42.4 


Type 
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Property 


WebKit2WebsiteDataManagertdisk-cache-directory 


deprecated: 2.40. since: 2.10 


Declaration 


property disk-cache-directory: utf8 [ read, write, construct-only ] 


Description 


The directory where HTTP disk cache will be stored. 


Type: gchar* 
Available since: 2.10 
Deprecated since: 2.40. 


Use WebKitWebsiteDataManager:base-cache-directory instead. 


Default value NULL 


Getter method |webkit_website_data_manager_get_disk_cache_directory () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 
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Property 


WebKit2\WebsiteDataManagertdom-cache-directory 


deprecated: 2.40. since: 2.30 


Declaration 


property dom-cache-directory: utf8 [ read, write, construct-only ] 


Description 


The directory where DOM cache will be stored. 


Type: gchar* 
Available since: 2.30 
Deprecated since: 2.40. 


Use WebKitWebsiteDataManager:base-cache-directory instead. 


Default value NULL 


Getter method |webkit_website_data_manager_get_dom_cache_directory () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Properties 


base-cache-directory}base-data-directory|disk-cache-directory|dom-cache-directory|hsts-cache-director 
indexeddb-directory|is-ephemerallitp-directory]local-storage-directoryJoffline-application-cache-director 
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Property 


WebKit2\WebsiteDataManagerthsts-cache-directory 


deprecated: 2.40. since: 2.26 


Declaration 


property hsts-cache-directory: utf8 [ read, write, construct-only ] 


Description 


The directory where the HTTP Strict-Transport-Security (HSTS) cache will be stored. 


Type: gchar* 
Available since: 2.26 
Deprecated since: 2.40. 


Use WebKitWebsiteDataManager:base-cache-directory instead. 


Default value NULL 


Getter method |webkit_website_data_manager_get_hsts_cache_directory () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Properties 


base-cache-directory}base-data-directory|disk-cache-directory|dom-cache-directory|hsts-cache-director 
indexeddb-directory|is-ephemerallfitp-directory]local-storage-directoryJoffline-application-cache-director 
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Property 


WebKit2\WebsiteDataManagertindexeddb-directory 


deprecated: 2.40. since: 2.10 


Declaration 


property indexeddb-directory: utf8 [ read, write, construct-only ] 


Description 


The directory where IndexedDB databases will be stored. 


Type: gchar* 
Available since: 2.10 
Deprecated since: 2.40. 


Use WebKitWebsiteDataManager:base-data-directory instead. 


Default value NULL 


Getter method |webkit_website_data_manager_get_indexeddb_directory () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Properties 


base-cache-directory}base-data-directory|disk-cache-directory{dom-cache-directory|hsts-cache-director 
indexeddb-directory|is-ephemerallitp-directory]local-storage-directoryJoffline-application-cache-director 
service-worker-registrations-directory|total-storage-ratio]websql-director 
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Property 
WebKit2\WebsiteDataManagertis-ephemeral 
since: 2.16 

Declaration 

property is-ephemeral: gboolean [ read, write, construct-only ] 


Description 


Whether the WebKitWebsiteDataManager is ephemeral. An ephemeral 
WebKitWebsiteDataManager handles all websites data as non-persistent, and nothing will be 
written to the client storage. Note that if you create an ephemeral WebKitWebsiteDataManager all 
other construction parameters to configure data directories will be ignored. 


Type: gboolean 
Available since: 2.16 


Default value FALSE 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Properties 


base-cache-directory}base-data-directory|disk-cache-directory{dom-cache-directory|hsts-cache-director 
indexeddb-directory|is-ephemerallitp-directory]local-storage-directoryJoffline-application-cache-director 
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Property 


WebKit2WebsiteDataManagertitp-directory 


deprecated: 2.40. since: 2.30 


Declaration 


property itp-directory: utf8 [ read, write, construct-only ] 


Description 


The directory where Intelligent Tracking Prevention (ITP) data will be stored. 


Type: gchar* 
Available since: 2.30 
Deprecated since: 2.40. 


Use WebKitWebsiteDataManager:base-data-directory instead. 


Default value NULL 


Getter method |webkit_website_data_manager_get_itp_directory () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Properties 


base-cache-directory}base-data-directory|disk-cache-directory|dom-cache-directory|hsts-cache-director 
indexeddb-directory|is-ephemerallitp-directory]local-storage-directoryJoffline-application-cache-director 
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Property 


WebKit2WebsiteDataManagertlocal-storage-directory 


deprecated: 2.40. since: 2.10 


Declaration 


property local-storage-directory: utf8 [ read, write, construct-only ] 


Description 


The directory where local storage data will be stored. 


Type: gchar* 
Available since: 2.10 
Deprecated since: 2.40. 


Use WebKitWebsiteDataManager:base-data-directory instead. 


Default value NULL 


Getter 


Histiod webkit_website data_manager_get_local_storage_directory () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Properties 


base-cache-directory}base-data-directory|disk-cache-directory{dom-cache-directory|hsts-cache-director 
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Property 


WebKitWebsiteDataManagertoffline-application-cache-directory 


deprecated: 2.40. since: 2.10 


Declaration 


property offline-application-cache-directory: utf8 [ read, write, construct-only ] 


Description 


The directory where offline web application cache will be stored. 


Type: gchar* 
Available since: 2.10 
Deprecated since: 2.40. 


Use WebKitWebsiteDataManager:base-cache-directory instead. 


Default 


NULL 
value 


Getter 
method 


webkit_website_data_manager_get_offline application_cache_directory () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Properties 


base-cache-directory}base-data-directory|disk-cache-directory|dom-cache-directory|hsts-cache-director 
indexeddb-directory|is-ephemerallitp-directory]local-storage-directoryJoffline-application-cache-director 
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Property 
WebKit2\WebsiteDataManagertorigin-storage-ratio 
since: 2.42 

Declaration 


property origin-storage-ratio: double [ write, construct-only ] 


Description 


The percentage of volume space that can be used for data storage for every domain. If the maximum 
storage is reached the storage request will fail with a QuotaExceededError exception. A value of 0.0 
means that data storage is not allowed. A value of -1.0, which is the default, means WebKit will use the 
default quota (1 GiB). 

Type: gdouble 


Available since: 2.42 


Default value = - 1.000000 


Flags 


Readable 
Writable 
Construct 


Construct only 


no 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Properties 


base-cache-directory}base-data-directory|disk-cache-directory{dom-cache-directory|hsts-cache-director 
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Property 


WebKitaWebsiteDataManagertservice-worker-registrations-directory 
deprecated: 2.40. since: 2.30 


Declaration 


property service-worker-registrations-—directory: utf8 [ read, write, construct-only ] 


Description 


The directory where service workers registrations will be stored. 


Type: gchar* 
Available since: 2.30 
Deprecated since: 2.40. 


Use WebKitWebsiteDataManager:base-data-directory instead. 


Default 
value 


NULL 


Getter 
method 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Properties 
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Property 


WebKit2\WebsiteDataManagerttotal-storage-ratio 


since: 2.42 


Declaration 


property total-storage-ratio: double [ write, construct-only ] 


Description 


The percentage of volume space that can be used for data storage for all domains. If the maximum storage 
is reached the eviction will happen. A value of 0.0 means that data storage is not allowed. A value of -1.0, 
which is the default, means there’s no limit for the total storage. 


Type: gdouble 
Available since: 2.42 


Default value = - 1.000000 


Flags 


Readable 
Writable 
Construct 


Construct only 


no 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Website DataManager 


Properties 
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Property 


WebKit2\WebsiteDataManagert websql-directory 


deprecated: 2.24. since: 2.10 


Declaration 


property websql-directory: utf8 [ read, write, construct-only ] 


Description 


The directory where WebSQL databases will be stored. 


Type: gchar* 
Available since: 2.10 
Deprecated since: 2.24. 


WebSQL is no longer supported. Use IndexedDB instead. 


Default value NULL 


Getter method |webkit_website_data_manager_get_websql_ directory () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 
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ebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Constructors 
new 
Instance methods 


get_autoplay_polic 


Properties 
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Class 


WebKit2/WebsitePolicies 


since: 2.30 


Description 


class WebKit2.WebsitePolicies : GObject.Object 
{ 

priv: WebKitWebsitePoliciesPrivate* 
} 


View specific website policies. 


WebKitWebsitePolicies allows you to configure per-page policies, currently only autoplay policies 
are supported. 


Available since: 2.30 


Hierarchy 


hierarchy this WebKitWebsitePolicies ancestor_O GObject ancestor_0--this 
Ancestors 
@ GObject 


Constructors 


webkit_website_policies_new 


Create anew WebKitWebsitePolicies. 


since: 2.30 


webkit_website_policies_new_with_policies 


Create anew WebKitWebsitePolicies with given policies. 


since: 2.30 


Instance methods 


webkit_website_policies_get_autoplay_policy 


Get the WebKitWebsitePolicies: autoplay property. 
since: 2.30 

Methods inherited from GObject (43) 

Please see GObject for a full list of methods. 


Properties 


WebKit2.WebsitePolicies:autoplay 


The WebKitAutoplayPolicy of WebKitWebsitePolicies. 
since: 2.30 

Signals 

Signals inherited from GObject (1) 


GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2WebsitePoliciesClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 
i 
void (* _webkit_reservedl) ( 

void 
i 
void (* _webkit_reserved2) ( 

void 
i 
void (* _webkit_reserved3) ( 

void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 


Content 


Ancestors 
Constructors 
ethods 
roperties 


eeeeee 
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S 
ss 
ie) 
> 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
WebsitePolicies 


Constructors 


new 
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Constructor 
WebKit2WebsitePoliciesnew 
since: 2.30 


Declaration 


WebKitWebsitePolicies* 
webkit_website_policies_new ( 
void 


) 


Description 


Create anew WebKitWebsitePolicies. 


Available since: 2.30 


Return value 


Type: |WebKitWebsitePolicies 


The newly created WebKitWebsitePolicies. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
'WebsitePolicies 


Constructors 


new 
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Constructor 
WebKit J ebsitePoliciesnew_with_policies 
since: 2.30 


Declaration 


WebKitWebsitePolicies* 
webkit_website_policies_new_with_policies ( 
const gchar* first_policy_name, 


Description 


Create anew WebKitWebsitePolicies with given policies. 
Create anew WebKitWebsitePolicies with policies given as variadic arguments. 
Available since: 2.30 


This method is not directly available to language bindings. 


Parameters 
first_policy_name 
Type: const gchar* 
Name of the first policy to set. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


Type: 


Value of first policy, followed by more policies, NULL-terminated. 


Return value 


Type: |WebKitWebsitePolicies 


The newly created WebKitWebsitePolicies 


WebKitWebsitePolicies *default_website_policies = webkit_website_policies_new_with_policies ( 
"autoplay", WEBKIT_AUTOPLAY_DENY, 


NULL) ; 
// 
WebKitWebView *view = WEBKIT_WEB_VIEW(g_object_new (WEBKIT_TYPE_WEB_VIEW, 
"web-context", ctx, 
"settings", settings, 
"user-content-manager", content_manager, 
"website-policies", default_website_policies, 
NULL) ); 


// 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
WebsitePolicies 


Methods 
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Method 
WebKit2WebsitePoliciesget_autoplay_policy 
since: 2.30 


Declaration 


WebKitAutoplayPolicy 
webkit_website_policies_get_autoplay_policy ( 
WebKitWebsitePolicies* policies 


) 


Description 


Get the WebKitWebsitePolicies: autoplay property. 


Available since: 2.30 


Return value 


Type:|WebKitAutoplayPolicy 


WebKitAutoplayPolicy. 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 
WebsitePolicies 


Properties 
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Property 


WebKit2WebsitePolicies:autoplay 


since: 2.30 


Declaration 


property autoplay: WebKit2.AutoplayPolicy [ read, write, construct-only ] 


Description 


The WebKitAutoplayPolicy of WebKitWebsitePolicies. 


Type: WebKitAutoplayPolicy 


Available since: 2.30 
Default value WEBKIT AUTOPLAY ALLOW_WITHOUT_SOUND 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Constructors 


new_with_contextInew_with_related_view|new_with_settingsJnew_with_user_content_manager 


Instance methods 


call_async_javascript_function}call_async_javascript_function_finish}can_execute_editing_ command 


Properties 


can_execute_editing command_finish}can_go_backjcan_go_forwardjcan_show_mime_type 


Signals 


authenticate context-menu-dismissed enter-fullscreen 
insecure-content-detected]leave-fullscreen]load-changed]load-failed]load-failed-with-tls-errors 


mouse-target-changed]permission-request|print|query-permission-state]ready-to-show 
resource-load-startedjrun-as-modalfrun-color-chooserjrun-file-chooser|script-dialog|show-notification| 
show-option-menu]submit-form]user-message-received]web-process-crashed]web-process-terminated 


Virtual methods 


Generated by 2023.3 
Class 


WebKit2\Web View 


unstable since: 4.1 


Description 


class WebKit2.WebView : WebKit2.WebViewBase 
implements Atk.ImplementorIface, Gtk.Buildable { 
priv: WebKitWebViewPrivate* 


} 


The central class of the WPE WebKit and WebKitGTK APIs. 


WebKitWebView is the central class of the WPE WebKit and WebKitGTK APIs. It is responsible for 
managing the drawing of the content and forwarding of events. You can load any URI into the 
WebKitWebView or a data string. With WebKit Settings you can control various aspects of the 
rendering and loading of the content. 


Note that in WebKitGTK, WebKitWebView is scrollable by itself, so you don’t need to embed it in a 
GtkScrolledWindow. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitWebView implements_0 AtkImplementorlIface this--implements_0 implements_1 


GtkBuildable this--implements_1 ancestor_0]}WebKitWebViewBaselancestor_0O--this ancestor_1 


GtkContainer ancestor_1--ancestor_0 ancestor_2 GtkWidget ancestor_2--ancestor_1 ancestor_3 
GInitially Unowned ancestor_3--ancestor_2 ancestor_4 GObject ancestor_4--ancestor_3 


Ancestors 


WebKitWebViewBase 


GtkContainer 
GtkWidget 
GInitially Unowned 
GObject 


Implements 


@ AtkImplementorIface 
@® GtkBuildable 


Constructors 

Creates a new WebKitWebView with the default WebKitWebContext. 
unstable since: 4.1 

Creates a new WebKitWebView with the given WebKitWebContext. 


unstable since: 4.1 


webkit_web_view_new_with_related_view 


Creates a new WebKit WebView sharing the same web process with web_view. 


since: 2.4 


webkit_web_view_new_with_settings 


Creates a new WebKitWebView with the given WebKitSettings. 


since: 2.6 


webkit_web_view_new_with_user_content_manager 


Creates a new WebKit WebView with the given WebKitUserContentManager. 


since: 2.6 


Instance methods 


webkit_web_view_call_async_javascript_function 


Asynchronously call body with arguments in the script world with name wor1d_name of the main 
frame current context in web_view. The arguments values must be one of the following types, or 
contain only the following GVariant types: number, string and dictionary. The result of the operation can 
be a Promise that will be properly passed to the callback. If world_name is NULL, the default world is 
used. Any value that is not NULL is a distin ct world. The source_uri will be shown in exceptions and 
doesn’t affect the behavior of the script. When not provided, the document URL is used. 


since: 2.40 


webkit_web_view_call_async_javascript_function_finish 


Finish an asynchronous operation started with webkit_web_view_call_async_javascript_function(). 


since: 2.40 


webkit_web_view_can_execute_editing_command 
Asynchronously check if it is possible to execute the given editing command. 


unstable since: 4.1 


webkit_web_view_can_execute_editing_command_finish 


Finish an asynchronous operation started with webkit_web_view_can_execute_editing command(). 


unstable since: 4.1 

Determines whether web_view has a previous history item. 
unstable since: 4.1 

Determines whether web_view has a next history item. 


unstable since: 4.1 


webkit_web_view_can_show_mime_type 


Whether or not a MIME type can be displayed in web_view. 


unstable since: 4.1 


webkit_web_view_download_uri 


Requests downloading of the specified URI string for web_view. 


unstable since: 4.1 


webkit_web_view_evaluate_javascript 


Asynchronously evaluate script in the script world with name world_name of the main frame current 
context in web_view. If world_name is NULL, the default world is used. Any value that is not NULL is 
a distinct world. The source_uri will be shown in exceptions and doesn’t affect the behavior of the 
script. When not provided, the document URL is used. 


since: 2.40 


webkit_web_view_evaluate_javascript_finish 


Finish an asynchronous operation started with webkit_web_view_evaluate_javascript(). 
since: 2.40 
Request to execute the given command for web_view. 


unstable since: 4.1 


webkit_web_view_execute_editing_command_with_argument 


Request to execute the given command with argument for web_view. 


since: 2.10 


webkit_web_view_get_automation_presentation_type 


Get the presentation type of WebKitWebView when created for automation. 


since: 2.28 


webkit_web_view_get_back_forward_list 


Obtains the WebKitBackForwardList associated with the given WebKitWebView. 


unstable since: 4.1 


webkit_web_view_get_background_color 


Gets the color that is used to draw the web_view background. 
since: 2.8 

[webkit_web_view_get_camera_capture_state] 

Get the camera capture state of aWebKitWebView. 

since: 2.34 

[webkit_web_view_get_context] 

Gets the web context of web_view. 

unstable since: 4.1 

[webkit_web_view_get_custom_charsef] 

Returns the current custom character encoding name of web_view. 


unstable since: 4.1 


webkit_web_view_get_default_content_security_policy 


Gets the configured default Content-Security-Policy. 

since: 2.38 

Get the display capture state of aWebKitWebView. 

since: 2.34 

[webkit_web_view_get_editor_state] 

Gets the web editor state of web_view. 

since: 2.10 

Gets the value of the WebKitWebView:estimated-load-progress property. 


unstable since: 4.1 


Returns favicon currently associated to web_view. 

unstable since: 4.1 

[webkit_web_view_get_find_controller| 

Gets the WebKitFindController. 

unstable since: 4.1 
[webkit_web_view_get_input_method_context] 

Get the WebKit InputMethodContext currently in use by web_view. 
since: 2.28 

[webkit_web_view_get_inspector| 

Get the WebKitWebInspector associated to web_view. 
unstable since: 4.1 

Gets the mute state of web_view. 


since: 2.30 


webkit_web_view_get_is_web_process_responsive 


Get whether the current web process of a WebKitWebView is responsive. 


since: 2.34 


webkit_web_view_get_javascript_global_context 


Get the global JavaScript context. 
unstable deprecated: 2.22 since: 4.1 
Return the main resource of web_ view. 


unstable since: 4.1 


webkit_web_view_get_microphone_capture_state 


Get the microphone capture state of aWebKitWebView. 
since: 2.34 

lwebkit_web_view_get_page_id] 

Get the identifier of the WebKitWebPage corresponding to the WebKitWebView. 
unstable since: 4.1 

[webkit_web_view_get_session_state] 

Gets the current session state of web_view. 

since: 2.12 

lwebkit_web_view_get_settings| 

Gets the WebKitSettings currently applied to web_view. 
unstable since: 4.1 


webkit_web_view_get_snapshot 


Asynchronously retrieves a snapshot of web_view for region. 


unstable since: 4.1 


webkit_web_view_get_snapshot_finish 


Finishes an asynchronous operation started with webkit_web_view_get_snapshot(). 


unstable since: 4.1 
Gets the value of the WebKitWebView: title property. 
unstable since: 4.1 
Retrieves the GTl1sCertificate associated with the main resource of web_view. 


unstable since: 4.1 


Returns the current active URI of web_view. 
unstable since: 4.1 
Gets the user content manager associated to web_view. 


since: 2.6 


webkit_web_view_get_web_extension_mode 


Get the view’s WebKitWebExtensionMode. 


since: 2.38 


webkit_web_view_get_website_data_manager 


Get the WebKitWebsiteDataManager associated to web_view. 


since: 2.16 


webkit_web_view_get_website_policies 


Gets the default website policies. 

since: 2.30 

Get the WebKitWindowProperties object. 
unstable since: 4.1 

Set the zoom level of web_view. 

unstable since: 4.1 

Loads the previous history item. 


unstable since: 4.1 


webkit_web_view_go_forward 


Loads the next history item. 


unstable since: 4.1 


webkit_web_view_go_to_back_forward_list_item 


Loads the specific history item list_item. 


unstable since: 4.1 


webkit_web_view_is_controlled_by_automation 


Get whether a WebKit WebView was created with 
WebKitWebView: is-—controlled—by-—automation property enabled. 


since: 2.18 

Gets whether the user is allowed to edit the HTML document. 
since: 2.8 

Get whether a WebKit WebView is ephemeral. 

since: 2.16 

Gets the value of the WebKitWebView: is-—loading property. 


unstable since: 4.1 


webkit_web_view_is_playing_audio 


Gets the value of the WebKitWebView: is-playing-—audio property. 
since: 2.8 
Load the given content string for the URI content_uri. 


unstable since: 4.1 


webkit_web_view_load_bytes 

Load the specified bytes into web_view using the given mime_t ype and encoding. 
since: 2.6 

[webkit_web_view_load_html] 

Load the given content string with the specified base_uri. 

unstable since: 4.1 

[webkit_web_view_load_plain_text] 

Load the specified plain_text string into web_view. 

unstable since: 4.1 

Requests loading of the specified WebKitURIRequest. 

unstable since: 4.1 

Requests loading of the specified URI string. 

unstable since: 4.1 

webkit_web_view_reload 

Reloads the current contents of web_view. 

unstable since: 4.1 

[webkit_web_view_reload_bypass_cache] 

Reloads the current contents of web_view without using any cached data. 
unstable since: 4.1 


Restore the web_view session state from state. 


since: 2.12 


webkit_web_view_run_async_javascript_function_in_world 


Asynchronously run body in the script world with name wor1d_name of the current page context in 
web_view. If WebKitSettings:enable-javascript is FALSE, this method will do nothing. This API differs 
from webkit_web_view_run_javascript_in_world() in that the JavaScript function can 
return a Promise and its result will be properly passed to the callback. 


deprecated: 2.40 since: 2.38 


webkit_web_view_run_javascript 


Asynchronously run script in the context of the current page in web_view. 


unstable deprecated: 2.40 since: 4.1 


webkit_web_view_run_javascript_finish 


Finish an asynchronous operation started with webkit_web_view_run_javascript(). 


unstable deprecated: 2.40 since: 4.1 


webkit_web_view_run_javascript_from_gresource 


Asynchronously run the script from resource. 


unstable deprecated: 2.40 since: 4.1 


webkit_web_view_run_javascript_from_gresource_finish 


Finish an asynchronous operation started with webkit_web_view_run_javascript_from_gresource(). 


unstable deprecated: 2.40 since: 4.1 


webkit_web_view_run_javascript_in_world 


Asynchronously run script in the script world. 


deprecated: 2.40 since: 2.22 


webkit_web_view_run_javascript_in_world_finish 


Finish an asynchronous operation started with webkit_web_view_run_javascript_in_world(). 


deprecated: 2.40 since: 2.22 


Asynchronously save the current web page. 

unstable since: 4.1 

Finish an asynchronous operation started with webkit_web_view_save(). 
unstable since: 4.1 

Asynchronously save the current web page. 


unstable since: 4.1 


webkit_web_view_save_to_file_finish 


Finish an asynchronous operation started with webkit_web_view_save_to_file(). 
unstable since: 4.1 
Send message to the WebKitWebPage corresponding to web_view. 


since: 2.28 


webkit_web_view_send_message_to_page_finish 


Finish an asynchronous operation started with webkit_web_view_send_message_to_page(). 


since: 2.28 

Sets the color that will be used to draw the web_view background. 
since: 2.8 

Set the camera capture state of aWebKitWebView. 


since: 2.34 


webkit_web_view_set_cors_allowlist 


Sets the allowlist for CORS. 

since: 2.34 

webkit_web_view_set_custom_charset 

Sets the current custom character encoding override of web_view. 
unstable since: 4.1 

webkit_web_view_set_display_capture_state 

Set the display capture state of aWebKitWebView. 

since: 2.34 

Sets whether the user is allowed to edit the HTML document. 

since: 2.8 

webkit_web_view_set_input_method_context 

Set the WebKit InputMethodContext to be used by web_view. 
since: 2.28 

Sets the mute state of web_view. 


since: 2.30 
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bkit_web_view_set_microphone_capture_state 

Set the microphone capture state of a WebKitWebView. 
since: 2.34 

Sets the WebKit Settings to be applied to web_view. 


unstable since: 4.1 


webkit_web_view_set_zoom_level 

Set the zoom level of web_view. 

unstable since: 4.1 

Stops any ongoing loading operation in web_view. 
unstable since: 4.1 
[webkit_web_view_terminate_web_process| 
Terminates the web process associated to web_view. 
since: 2.34 

Tries to close the web_view. 

since: 2.12 

Methods inherited from GtkContainer (33) 
Please see GtkContainer for a full list of methods. 
Methods inherited from GtkWidget (263) 
Please see GtkWidget for a full list of methods. 
Methods inherited from GObject (43) 

Please see GObject for a full list of methods. 
Methods inherited from GtkBuildable (10) 
gtk_buildable_add_child 

Adds a child to buildable. type is an optional string describing how the child should be added. 
since: 2.12 

gtk_buildable_construct_child 


Constructs a child of buildable with the name name. 


since: 2.12 
gtk_buildable_custom_finished 


This is similar to gtk_buildable_parser_finished() but is called once for each custom tag 
handled by the buildable. 


since: 2.12 

gtk_buildable_custom_tag_end 

This is called at the end of each custom element handled by the buildable. 
since: 2.12 

gtk_buildable_custom_tag_start 

This is called for each unknown element under <child>. 

since: 2.12 

gtk_buildable_get_internal_child 

Get the internal child called childname of the buildable object. 
since: 2.12 

gtk_buildable_get_name 

Gets the name of the buildable object. 

since: 2.12 

gtk_buildable_parser_finished 


Called when the builder finishes the parsing of a [GtkBuilder UI definition][BUILDER-UI]. Note that this 
will be called once for each time gtk_builder_add_from_file() or 
gtk_builder_add_from_string() is called on a builder. 


since: 2.12 
gtk_buildable_set_buildable_property 
Sets the property name name to value on the buildable object. 


since: 2.12 


gtk_buildable_set_name 
Sets the name of the buildable object. 


since: 2.12 


Properties 


WebKit2.Web View:automation-presentation-type 


The WebKitAutomationBrowsingContextPresentation of WebKitWebView. This should 
only be used when creating a new WebKitWebView as a response to 
WebKitAutomationSession: :create-web-—view signal request. If the new WebView was 
added to a new tab of current browsing context window 
WEBKIT_AUTOMATION_BROWSING_CONTEXT_PRESENTATION_TAB should be used. 


since: 2.28 


WebKit2.WebView:camera-capture-state 


Capture state of the camera device. Whenever the user grants a media-request sent by the web page, 
requesting video capture capabilities (navigator.mediaDevices.getUserMedia ({video: 
true}) ) this property will be set to WEBKIT_MEDIA_CAPTURE_STATE_ACTIVE. 


since: 2.34 


WebKit2.Web View:default-content-security-policy 


The default Content-Security-Policy used by the webview as if it were set by an HTTP header. 


since: 2.38 


WebKit2.WebView:display-capture-state 


Capture state of the display device. Whenever the user grants a media-request sent by the web page, 
requesting screencasting capabilities (navigator.mediaDevices.getDisplayMedia() this 
property will be set toWEBKIT_MEDIA_CAPTURE_STATE_ACTIVE*. 


since: 2.34 


WebKit2.Web View: editable 


Whether the pages loaded inside WebKitWebView are editable. For more information 
see webkit_web_view_set_editable(). 


since: 2.8 


WebKit2.Web View: estimated-load-progress 


An estimate of the percent completion for the current loading operation. This value will range from 0.0 to 
1.0 and, once a load completes, will remain at 1.0 until a new load starts, at which point it will be reset to 
0.0. The value is an estimate based on the total number of bytes expected to be received for a document, 
including all its possible subresources and child documents. 


unstable since: 4.1 


WebKit2.WebView:favicon| 


The favicon currently associated to the WebKitWebView. See 
webkit_web_view_get_favicon() for more details. 


unstable since: 4.1 


WebKit2.WebView:is-controlled-by-automation 


Whether the WebKitWebView is controlled by automation. This should only be used when creating a 
new WebKitWebView as a response to WebKitAutomationSession: :create-web-view 
signal request. 


since: 2.18 


WebKit2.WebView:is-ephemeral 


Whether the WebKitWebView is ephemeral. An ephemeral web view never writes website data to the 
client storage, no matter what WebKitWebsiteDataManager its context is using. This is normally 
used to implement private browsing mode. This is a G_PARAM_CONSTRUCT_ONLY property, so you 
have to create an ephemeral WebKitWebView and it can’t be changed. The ephemeral 
WebKitWebsiteDataManager created for the WebKitWebView will inherit the network settings 
from the WebKitWebContext‘s WebKitWebsiteDataManager. To use different settings you can 
get the WebKitWebsiteDataManager with 
webkit_web_view_get_website_data_manager () and set the new ones. Note that all 
WebKitWebViews created with an ephemeral WebKitWebContext will be ephemeral automatically. 
See also webkit_web_context_new_ephemeral(). 


since: 2.16 


WebKit2.WebView:is-loading 


Whether the WebKitWebView is currently loading a page. This property becomes TRUE as soon as a 
new load operation is requested and before the WebKitWebView: : load-changed signal is emitted 
with WEBKIT_LOAD_STARTED and at that point the active URI is the requested one. When the load 
operation finishes the property is set to FALSE before WebKitWebView: : load-changed is emitted 
with WEBKIT_LOAD_FINISHED. 


unstable since: 4.1 


WebKit2.Web View:is-muted 


Whether the WebKitWebView audio is muted. When TRUE, audio is silenced. It may still be playing, i.e. 
WebKitWebView:is-—playing-—audio may be TRUE. 


since: 2.30 


WebKit2.WebView:is-playing-audio 


Whether the WebKitWebView is currently playing audio from a page. This property becomes TRUE as 
soon as web content starts playing any kind of audio. When a page is no longer playing any kind of sound, 
the property is set back to FALSE. 


since: 2.8 


WebKit2.Web View:is-web-process-responsive 


Whether the web process currently associated to the WebKitWebView is responsive. 


since: 2.34 


WebKit2.Web View:microphone-capture-state 


Capture state of the microphone device. Whenever the user grants a media-request sent by the web page, 
requesting audio capture capabilities (navigator.mediaDevices.getUserMedia ({audio: 
true}) ) this property will be set to WEBKIT_MEDIA_CAPTURE_STATE_ACTIVE. 


since: 2.34 
The identifier of the WebKitWebPage corresponding to the WebKitWebView. 
since: 2.28 


WebKit2.WebView:related-view 


The related WebKit WebView used when creating the view to share the same web process and network 
session. This property is not readable because the related web view is only valid during the 
object construction. 


since: 2.4 


WebKit2.WebView:settings 


The WebKitSettings of the view. 
since: 2.6 


WebKit2.WebView:title 


The main frame document title of this WebKitWebView. If the title has not been received yet, it will be 
NULL. 


WebKit2.WebView:uri 
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The current active URI of the WebKitWebView. See webkit_web_view_get_uri () for 
more details. 


unstable since: 4.1 


WebKit2.Web View: user-content-manager 

The WebKitUserContentManager of the view. 
since: 2.6 

The WebKitWebContext of the view. 

unstable since: 4.1 


WebKit2.Web View: web-extension-mode 


This configures web_view to treat the content as a WebExtension. 


since: 2.38 
The WebKitWebsitePolicies for the view. 
since: 2.30 


WebKit2.WebView:zoom-level 


The zoom level of the WebKitWebView content. See webkit_web_view_set_zoom_level () 
for more details. 


unstable since: 4.1 


Properties inherited from GtkContainer (3) 


Gtk.Container:border-width 


No description available. 
unstable since: 3.0 


Gtk.Container: child 


No description available. 
unstable since: 3.0 


Gtk.Container:resize-mode 


No description available. 
unstable since: 3.0 


Properties inherited from GtkWidget (39) 
Gtk. Widget:app-paintable 


No description available. 
unstable since: 3.0 


Gtk. Widget:can-default 


No description available. 
unstable since: 3.0 


Gtk. Widget:can-focus 


No description available. 
unstable since: 3.0 


Gtk.Widget:composite-child 


No description available. 
unstable since: 3.0 
Gtk. Widget:double-buffered 


Whether the widget is double buffered. 


deprecated: 3.14 since: 2.18 


Gtk. Widget:events 


No description available. 
unstable since: 3.0 
Gtk. Widget:expand 


Whether to expand in both directions. Setting this sets both GtkWidget :hexpand and 
GtkWidget : vexpand. 


unstable since: 3.0 

Gtk. Widget:focus-on-click 

Whether the widget should grab focus when it is clicked with the mouse. 
unstable since: 3.20 

Gtk. Widget:halign 

How to distribute horizontal space if widget gets extra space, see GtkAlign. 
unstable since: 3.0 


Gtk. Widget:has-default 


No description available. 
unstable since: 3.0 


Gtk. Widget:has-focus 


No description available. 
unstable since: 3.0 
Gtk. Widget:has-tooltip 


Enables or disables the emission of GtkWidget: :query-tooltip on widget. A value of TRUE 
indicates that widget can have a tooltip, in this case the widget will be queried using 
GtkWidget: :query-tooltip to determine whether it will provide a tooltip or not. 


since: 2.12 


Gtk. Widget:height-request 


No description available. 

unstable since: 3.0 

Gtk. Widget:hexpand 

Whether to expand horizontally. See gtk_widget_set_hexpand(). 

unstable since: 3.0 

Gtk. Widget:hexpand-set 

Whether to use the GtkWidget : hexpand property. See gtk_widget_get_hexpand_set(). 
unstable since: 3.0 


Gtk. Widget:is-focus 


No description available. 

unstable since: 3.0 

Gtk.Widget:margin 

Sets all four sides’ margin at once. If read, returns max margin on any side. 
unstable since: 3.0 

Gtk. Widget:margin-bottom 

Margin on bottom side of widget. 

unstable since: 3.0 

Gtk.Widget:margin-end 

Margin on end of widget, horizontally. This property supports left-to-right and right-to-left text directions. 
unstable since: 3.12 

Gtk. Widget:margin-left 

Margin on left side of widget. 


unstable deprecated: 3.12 since: 3.0 


Gtk.Widget:margin-right 

Margin on right side of widget. 
unstable deprecated: 3.12 since: 3.0 
Gtk.Widget:margin-start 


Margin on start of widget, horizontally. This property supports left-to-right and right-to-left 
text directions. 


unstable since: 3.12 
Gtk.Widget:margin-top 
Margin on top side of widget. 
unstable since: 3.0 


Gtk.Widget:name 


No description available. 
unstable since: 3.0 


Gtk. Widget:no-show-all 


No description available. 
unstable since: 3.0 
Gtk. Widget: opacity 


The requested opacity of the widget. See gtk_widget_set_opacity () for more details about 
window opacity. 


unstable since: 3.8 


Gtk.Widget:parent 


No description available. 
unstable since: 3.0 


Gtk. Widget:receives-default 


No description available. 


unstable since: 3.0 


Gtk. Widget:scale-factor 


The scale factor of the widget. See gtk_widget_get_scale_factor() for more details about 
widget scaling. 


unstable since: 3.10 


Gtk. Widget:sensitive 


No description available. 

unstable since: 3.0 

Gtk.Widget:style 

The style of the widget, which contains information about how it will look (colors, etc). 
unstable deprecated: Unknown since: 3.0 

Gtk. Widget:tooltip-markup 


Sets the text of tooltip to be the given string, which is marked up with the [Pango text markup 
language ][PangoMarkupFormat]. Also see gtk_tooltip_set_markup(). 


since: 2.12 

Gtk. Widget:tooltip-text 

Sets the text of tooltip to be the given string. 

since: 2.12 

Gtk. Widget: valign 

How to distribute vertical space if widget gets extra space, see GtkAlign. 
unstable since: 3.0 

Gtk. Widget:vexpand 

Whether to expand vertically. See gtk_widget_set_vexpand(). 
unstable since: 3.0 

Gtk. Widget: vexpand-set 


Whether to use the GtkWidget : vexpand property. See gtk_widget_get_vexpand_set(). 


unstable since: 3.0 


Gtk. Widget: visible 


No description available. 
unstable since: 3.0 


Gtk. Widget: width-request 


No description available. 

unstable since: 3.0 

Gtk.Widget:window 

The widget’s window if it is realized, NULL otherwise. 


since: 2.14 


Signals 
WebKit2.WebView::authenticate 


This signal is emitted when the user is challenged with HTTP authentication. To let the application access 
or supply the credentials as well as to allow the client application to either cancel the request or perform 
the authentication, the signal will pass an instance of the WebKitAuthenticationRequest in the 
request argument. To handle this signal asynchronously you should keep a ref of the request and return 
TRUE. To disable HTTP authentication entirely, connect to this signal and simply return TRUE. 


since: 2.2 


WebKit2.WebView::close 


Emitted when closing a WebKit WebView is requested. This occurs when a call is made from 
JavaScript’s window.close function or after trying to close the web_view with 
webkit_web_view_try_close(). It is the owner’s responsibility to handle this signal to hide or destroy the 
WebKitWebView, if necessary. 


unstable since: 4.1 


WebKit2.WebView::context-menu 


Emitted when a context menu is about to be displayed to give the application a chance to customize the 
proposed menu, prevent the menu from being displayed, or build its own context menu. To customize the 
proposed menu you can use webkit_context_menu_prepend(), webkit_context_menu_append () 
or webkit_context_menu_insert () to add new WebKitContextMenulItems to 
context_menu, webkit_context_menu_move_item() to reorder existing items, or 
webkit_context_menu_remove () to remove an existing item. The signal handler should return 
FALSE, and the menu represented by context_menu will be shown. To prevent the menu from being 


displayed you can just connect to this signal and return TRUE so that the proposed menu will not be 
shown. To build your own menu, you can remove all items from the proposed menu with 
webkit_context_menu_remove_all(), add your own items and return FALSE so that the menu will be 
shown. You can also ignore the proposed WebKitContextMenu, build your own Gt kMenu and return 
TRUE to prevent the proposed menu from being shown. If you just want the default menu to be shown 
always, simply don’t connect to this signal because showing the proposed context menu is the default 
behaviour. 


unstable since: 4.1 


WebKit2.Web View::context-menu-dismissed 


Emitted after WebKitWebView: :context-—menu signal, if the context menu is shown, to notify that 
the context menu is dismissed. 


unstable since: 4.1 


WebKit2.WebView::create 


Emitted when the creation of a new WebKit WebView is requested. If this signal is handled the signal 
handler should return the newly created WebKitWebView. 


unstable since: 4.1 
WebKit2.Web View: :decide-policy 


This signal is emitted when WebKit is requesting the client to decide a policy decision, such as whether to 
navigate to a page, open a new window or whether or not to download a resource. The 
WebKitNavigationPolicyDecision passed in the decision argument is a generic type, but 
should be casted to a more specific type when making the decision. For example: 


unstable since: 4.1 


WebKit2.WebView::enter-fullscreen 


Emitted when JavaScript code calls element.webkitRequestFullScreen. If the signal is not handled the 
WebKitWebView will proceed to full screen its top level window. This signal can be used by client code 
to request permission to the user prior doing the full screen transition and eventually prepare the top-level 
window (e.g. hide some widgets that would otherwise be part of the full screen window). 


unstable since: 4.1 


WebKit2.Web View: :insecure-content-detected 


This signal is emitted when insecure content has been detected in a page loaded through a secure 
connection. This typically means that a external resource from an unstrusted source has been run or 
displayed, resulting in a mix of HTTPS and non-HTTPS content. 


unstable since: 4.1 


WebKit2.WebView::leave-fullscreen 


Emitted when the WebKit WebView is about to restore its top level window out of its full screen state. 
This signal can be used by client code to restore widgets hidden during the 
WebKitWebView: :enter—fullscreen stage for instance. 


unstable since: 4.1 


WebKit2.WebView::load-changed 


Emitted when a load operation in web_view changes. The signal is always emitted with 
WEBKIT_LOAD_STARTED when a new load request is made and WEBKIT_LOAD_F INISHED when the 
load finishes successfully or due to an error. When the ongoing load operation fails 

WebKitWebView: : load-failed signal is emitted before WebKitWebView: : load-changed is 
emitted with WEBKIT_LOAD FINISHED. If a redirection is received from the server, this signal is 
emitted with WEBKIT_LOAD_REDIRECTED after the initial emission with WEBKIT_LOAD_STARTED 
and before WEBKIT_LOAD_COMMITTED. When the page content starts arriving the signal is emitted 
with WEBKIT_LOAD_COMMITTED event. 


unstable since: 4.1 


WebKit2.WebView::load-failed 


Emitted when an error occurs during a load operation. If the error happened when starting to load data for 
a page load_event will be WEBKIT_LOAD_STARTED. If it happened while loading a committed data 
source load_event will be WEBKIT_LOAD_COMMITTED. Since a load error causes the load operation 
to finish, the signal WebKitWebView::load-changed will always be emitted with 
WEBKIT_LOAD_FINISHED event right after this one. 


unstable since: 4.1 


WebKit2.WebView::load-failed-with-tls-errors 


Emitted when a TLS error occurs during a load operation. To allow an exception for this certificate 
and the host of failing_uri use webkit_web_context_allow_tls_certificate_for_host(). 


since: 2.6 


WebKit2.Web View: :mouse-target-changed 


This signal is emitted when the mouse cursor moves over an element such as a link, image or a media 
element. To determine what type of element the mouse cursor is over, a Hit Test is performed on the 
current mouse coordinates and the result is passed in the hit_test_result argument. The 
modifiers argument is a bitmask of GdkModifierType flags indicating the state of modifier keys. 
The signal is emitted again when the mouse is moved out of the current element with a new 
hit_test_result. 


unstable since: 4.1 


WebKit2.Web View::permission-request 


This signal is emitted when WebKit is requesting the client to decide about a permission request, such as 
allowing the browser to switch to fullscreen mode, sharing its location or similar operations. 


unstable since: 4.1 


WebKit2.WebView::print 


Emitted when printing is requested on web_view, usually by a JavaScript call, before the print dialog is 
shown. This signal can be used to set the initial print settings and page setup of print_operation to 
be used as default values in the print dialog. You can call 
webkit_print_operation_set_print_settings() and 
webkit_print_operation_set_page_setup () and then return FALSE to propagate the event 
so that the print dialog is shown. 


unstable since: 4.1 


WebKit2.Web View::query-permission-state 


This signal allows the User-Agent to respond to permission requests for powerful features, as specified by 


the|Permissions W3C Specification} You can reply to the query 


using webkit_permission_state_query_finish(). 


since: 2.40 


WebKit2.WebView::ready-to-show 


Emitted after WebKitWebView: : create on the newly created WebKitWebView when it should be 
displayed to the user. When this signal is emitted all the information about how the window should look, 
including size, position, whether the location, status and scrollbars should be displayed, is already set on 
the WebKitWindowProperties of web_view. See 

also webkit_web_view_get_window_properties(). 


unstable since: 4.1 


WebKit2.WebView::resource-load-started 


Emitted when a new resource is going to be loaded. The request parameter contains the 
WebKitURIRequest that will be sent to the server. You can monitor the load operation by connecting 
to the different signals of resource. 


unstable since: 4.1 


WebKit2.Web View: :run-as-modal 


Emitted after WebKitWebView: : ready—to-show on the newly created WebKitWebView when 
JavaScript code calls window.showModalDialog. The purpose of this signal is to allow the client 
application to prepare the new view to behave as modal. Once the signal is emitted a new main loop will 
be run to block user interaction in the parent WebKitWebView until the new dialog is closed. 


unstable since: 4.1 
WebKit2.WebView::run-color-chooser 


This signal is emitted when the user interacts with a HTML element, requesting from WebKit to show a 
dialog to select a color. To let the application know the details of the color chooser, as well as to allow the 
client application to either cancel the request or perform an actual color selection, the signal will pass an 
instance of the WebKitColorChooserRequest in the request argument. 


since: 2.8 


WebKit2.WebView::run-file-chooser 


This signal is emitted when the user interacts with a HTML element, requesting from WebKit to show a 
dialog to select one or more files to be uploaded. To let the application know the details of the file 
chooser, as well as to allow the client application to either cancel the request or perform an actual selection 
of files, the signal will pass an instance of the WebKitFileChooserRequest in the request 
argument. 


unstable since: 4.1 


WebKit2.WebView::script-dialog 


Emitted when JavaScript code calls window.alert, window.confirm or window.prompt, or when 
onbeforeunload event is fired. The dialog parameter should be used to build the dialog. If the signal is 
not handled a different dialog will be built and shown depending on the dialog type: 
WEBKIT_SCRIPT_DIALOG_ALERT: message dialog with a single Close button. 
WEBKIT_SCRIPT_DIALOG_CONF IRM: message dialog with OK and Cancel buttons. 
WEBKIT_SCRIPT_DIALOG_PROMPT: message dialog with OK and Cancel buttons and a text entry 
with the default text. WEBKIT_SCRIPT_DIALOG_BEFORE_UNLOAD_CONF IRM: message dialog with 
Stay and Leave buttons. 


unstable since: 4.1 


This signal is emitted when a notification should be presented to the user. The notification is kept 
alive until either: 1) the web page cancels it or 2) a navigation happens. 


since: 2.8 


WebKit2.WebView::show-option-menu 


This signal is emitted when a select element in web_view needs to display a dropdown menu. This signal 
can be used to show a custom menu, using menu to get the details of all items that should be displayed. 
The area of the element in the WebKitWebView is given as rectangle parameter, it can be used to 
position the menu. If this was triggered by a user interaction, like a mouse click, event parameter 
provides the GdkEvent. To handle this signal asynchronously you should keep a ref of the menu. 


since: 2.18 


WebKit2.WebView::submit-form 


This signal is emitted when a form is about to be submitted. The request argument passed contains 
information about the text fields of the form. This is typically used to store login information that can be 
used later to pre-fill the form. The form will not be submitted until 
webkit_form_submission_request_submit () is called. 


unstable since: 4.1 


WebKit2.Web View: :user-message-received 


This signal is emitted when a WebKitUserMessage is received from the WebKitWebPage 
corresponding to web_view. You can reply to the message using webkit_user_message_send_reply(). 


since: 2.28 

This signal is emitted when the web process crashes. 

unstable deprecated: 2.20 since: 4.1 

This signal is emitted when the web process terminates abnormally due to reason. 
since: 2.20 


Signals inherited from GtkContainer (4) 
GtkContainer::add 


No description available. 


unstable since: 3.0 


GtkContainer::check-resize 


No description available. 
unstable since: 3.0 


GtkContainer::remove 


No description available. 
unstable since: 3.0 


GtkContainer::set-focus-child 


No description available. 
unstable since: 3.0 


Signals inherited from GtkWidget (69) 


GtkWidget::accel-closures-changed 


No description available. 

unstable since: 3.0 

GtkWidget::button-press-event 

The ::button-press-event signal will be emitted when a button (typically from a mouse) is pressed. 
unstable since: 3.0 

GtkWidget::button-release-event 

The ::button-release-event signal will be emitted when a button (typically from a mouse) is released. 
unstable since: 3.0 

GtkWidget::can-activate-accel 


Determines whether an accelerator that activates the signal identified by signal_idcan currently be 
activated. This signal is present to allow applications and derived widgets to override the default 
GtkWidget handling for determining whether an accelerator can be activated. 


unstable since: 3.0 
GtkWidget: :child-notify 


The ::child-notify signal is emitted for each [child property][child-properties] that has changed on an 
object. The signal’s detail holds the property name. 


unstable since: 3.0 
GtkWidget::composited-changed 


The ::composited-changed signal is emitted when the composited status of widgets screen changes. 
See gdk_screen_is_composited(). 


unstable deprecated: 3.22 since: 3.0 
GtkWidget::configure-event 


The ::configure-event signal will be emitted when the size, position or stacking of the widget ‘s window 
has changed. 


unstable since: 3.0 
GtkWidget::damage-event 


Emitted when a redirected window belonging to widget gets drawn into. The region/area members of the 
event shows what area of the redirected drawable was drawn into. 


since: 2.14 
GtkWidget::delete-event 


The ::delete-event signal is emitted if a user requests that a toplevel window is closed. The default handler 
for this signal destroys the window. Connecting gtk_widget_hide_on_delete() to this signal will 
cause the window to be hidden instead, so that it can later be shown again without reconstructing it. 


unstable since: 3.0 
GtkWidget: :destroy 


Signals that all holders of a reference to the widget should release the reference that they hold. May result 
in finalization of the widget if all references are released. 


unstable since: 3.0 
GtkWidget::destroy-event 


The ::destroy-event signal is emitted when a GdkWindow is destroyed. You rarely get this signal, because 
most widgets disconnect themselves from their window before they destroy it, so no widget owns the 
window at destroy time. 


unstable since: 3.0 


GtkWidget::direction-changed 

The ::direction-changed signal is emitted when the text direction of a widget changes. 
unstable since: 3.0 

GtkWidget::drag-begin 


The ::drag-begin signal is emitted on the drag source when a drag is started. A typical reason to connect to 
this signal is to set up a custom drag icon with e.g. gtk_drag_source_set_icon_pixbuf(). 


unstable since: 3.0 
GtkWidget::drag-data-delete 


The ::drag-data-delete signal is emitted on the drag source when a drag with the action 
GDK_ACTION_MOVE is successfully completed. The signal handler is responsible for deleting the data 
that has been dropped. What “delete” means depends on the context of the drag operation. 


unstable since: 3.0 
GtkWidget::drag-data-get 


The ::drag-data-get signal is emitted on the drag source when the drop site requests the data which is 
dragged. It is the responsibility of the signal handler to fill data with the data in the format which is 
indicated by info. See gtk_selection_data_set () and gtk_selection_data_set_text(). 


unstable since: 3.0 
GtkWidget::drag-data-received 


The ::drag-data-received signal is emitted on the drop site when the dragged data has been received. If the 
data was received in order to determine whether the drop will be accepted, the handler is expected to call 
gdk_drag_status () and not finish the drag. If the data was received in response to a 

GtkWidget: :drag-—drop signal (and this is the last target to be received), the handler for this signal is 
expected to process the received data and then call gtk_drag_finishQ), setting the success parameter 
depending on whether the data was processed successfully. 


unstable since: 3.0 
GtkWidget::drag-drop 


The ::drag-drop signal is emitted on the drop site when the user drops the data onto the widget. The signal 
handler must determine whether the cursor position is in a drop zone or not. If it is not in a drop zone, it 
returns FALSE and no further processing is necessary. Otherwise, the handler returns TRUE. In this case, 
the handler must ensure that gtk_drag_finish () is called to let the source know that the drop is 
done. The call to gtk_drag_finish() can be done either directly or in a 

GtkWidget: :drag-data-received handler which gets triggered by calling 
gtk_drag_get_data() to receive the data for one or more of the supported targets. 


unstable since: 3.0 
GtkWidget::drag-end 


The ::drag-end signal is emitted on the drag source when a drag is finished. A typical reason to connect to 
this signal is to undo things done in GtkWidget : :drag—begin. 


unstable since: 3.0 
GtkWidget::drag-failed 


The ::drag-failed signal is emitted on the drag source when a drag has failed. The signal handler may hook 
custom code to handle a failed DnD operation based on the type of error, it returns TRUE is the failure has 
been already handled (not showing the default “drag operation failed” animation), otherwise it returns 
FALSE. 


since: 2.12 
GtkWidget::drag-leave 


The ::drag-leave signal is emitted on the drop site when the cursor leaves the widget. A typical reason to 
connect to this signal is to undo things done in GtkWidget : :drag-—motion, e.g. undo highlighting 
with gtk_drag_unhighlight(). 


unstable since: 3.0 
GtkWidget::drag-motion 


The ::drag-motion signal is emitted on the drop site when the user moves the cursor over the widget during 
a drag. The signal handler must determine whether the cursor position is in a drop zone or not. If it is not 
in a drop zone, it returns FALSE and no further processing is necessary. Otherwise, the handler returns 
TRUE. In this case, the handler is responsible for providing the necessary information for displaying 
feedback to the user, by calling gdk_drag_status(). 


unstable since: 3.0 
GtkWidget::draw 


This signal is emitted when a widget is supposed to render itself. The widget ‘s top left corner must be 
painted at the origin of the passed in context and be sized to the values returned by 
gtk_widget_get_allocated_width () and gtk_widget_get_allocated_height(). 


unstable since: 3.0 


GtkWidget::enter-notify-event 

The ::enter-notify-event will be emitted when the pointer enters the widget ‘s window. 
unstable since: 3.0 

GtkWidget::event 


The GTK+ main loop will emit three signals for each GDK event delivered to a widget: one generic 
s:event signal, another, more specific, signal that matches the type of event delivered (e.g. 
GtkWidget: :key—press-—event) and finally a generic GtkWidget: :event-after signal. 


unstable since: 3.0 
GtkWidget::event-after 


After the emission of the GtkWidget: :event signal and (optionally) the second more specific signal, 
s:event-after will be emitted regardless of the previous two signals handlers return values. 


unstable since: 3.0 


GtkWidget::focus 


No description available. 

unstable since: 3.0 

GtkWidget: :focus-in-event 

The ::focus-in-event signal will be emitted when the keyboard focus enters the widget ‘s window. 
unstable since: 3.0 

GtkWidget: :focus-out-event 

The ::focus-out-event signal will be emitted when the keyboard focus leaves the widget ‘s window. 
unstable since: 3.0 

GtkWidget::grab-broken-event 

Emitted when a pointer or keyboard grab on a window belonging to widget gets broken. 

since: 2.8 


GtkWidget::grab-focus 


No description available. 


unstable since: 3.0 
GtkWidget::grab-notify 


The ::grab-notify signal is emitted when a widget becomes shadowed by a GTK+ grab (not a pointer or 
keyboard grab) on another widget, or when it becomes unshadowed due to a grab being removed. 


unstable since: 3.0 

GtkWidget: :hide 

The ::hide signal is emitted when widget is hidden, for example with gtk_widget_hide(). 
unstable since: 3.0 

GtkWidget: :hierarchy-changed 


The ::hierarchy-changed signal is emitted when the anchored state of a widget changes. A widget is 
aanchoreda when its toplevel ancestor is a Gt kWindow. This signal is emitted when a widget changes 
from un-anchored to anchored or vice-versa. 


unstable since: 3.0 
GtkWidget::key-press-event 


The ::key-press-event signal is emitted when a key is pressed. The signal emission will reoccur at the 
key-repeat rate when the key is kept pressed. 


unstable since: 3.0 

GtkWidget::key-release-event 

The ::key-release-event signal is emitted when a key is released. 

unstable since: 3.0 

GtkWidget::keynav-failed 

Gets emitted if keyboard navigation fails. See gtk_widget_keynav_failed() for details. 
since: 2.12 

GtkWidget: :leave-notify-event 

The ::leave-notify-event will be emitted when the pointer leaves the widget ‘s window. 


unstable since: 3.0 


GtkWidget::map 


The ::map signal is emitted when widget is going to be mapped, that is when the widget is visible 
(which is controlled with gtk_widget_set_visible()) and all its parents up to the toplevel widget are also 
visible. Once the map has occurred, GtkWidget: :map-—event will be emitted. 


unstable since: 3.0 
GtkWidget::map-event 


The ::map-event signal will be emitted when the widget ‘s window is mapped. A window is mapped 
when it becomes visible on the screen. 


unstable since: 3.0 
GtkWidget: :mnemonic-activate 


The default handler for this signal activates widget if group_cycling is FALSE, or just makes 
widget grab focus if group_cycling is TRUE. 


unstable since: 3.0 

GtkWidget: :motion-notify-event 

The ::motion-notify-event signal is emitted when the pointer moves over the widget’s GdkWindow. 
unstable since: 3.0 


GtkWidget::move-focus 


No description available. 

unstable since: 3.0 

GtkWidget::parent-set 

The ::parent-set signal is emitted when a new parent has been set on a widget. 
unstable since: 3.0 

GtkWidget::popup-menu 


This signal gets emitted whenever a widget should pop up a context menu. This usually happens through 
the standard key binding mechanism; by pressing a certain key while a widget is focused, the user can 
cause the widget to pop up a menu. For example, the GtkEnt ry widget creates a menu with clipboard 
commands. See the [Popup Menu Migration Checklist][checklist-popup-menu] for an example of how to 
use this signal. 


unstable since: 3.0 
GtkWidget::property-notify-event 


The ::property-notify-event signal will be emitted when a property on the widget ‘s window has been 
changed or deleted. 


unstable since: 3.0 
GtkWidget::proximity-in-event 


To receive this signal the GdkWindow associated to the widget needs to enable the 
#GDK_PROXIMITY_IN_MASK mask. 


unstable since: 3.0 
GtkWidget::proximity-out-event 


To receive this signal the GdkWindow associated to the widget needs to enable the 
#GDK_PROXIMITY_OUT_MASK mask. 


unstable since: 3.0 
GtkWidget::query-tooltip 


Emitted when GtkWidget :has—tooltip is TRUE and the hover timeout has expired with the cursor 
hovering “above” widget; or emitted when widget got focus in keyboard mode. 


since: 2.12 
GtkWidget::realize 


The ::realize signal is emitted when widget is associated with a GdkWindow, which means that 
gtk_widget_realize() has been called or the widget has been mapped (that is, it is going to 
be drawn). 


unstable since: 3.0 

GtkWidget::screen-changed 

The ::screen-changed signal gets emitted when the screen of a widget has changed. 
unstable since: 3.0 

GtkWidget::scroll-event 


The ::scroll-event signal is emitted when a button in the 4 to 7 range is pressed. Wheel mice are usually 
configured to generate button press events for buttons 4 and 5 when the wheel is turned. 


unstable since: 3.0 
GtkWidget::selection-clear-event 


The ::selection-clear-event signal will be emitted when the the widget ‘s window has lost ownership of 
a selection. 


unstable since: 3.0 


GtkWidget::selection-get 


No description available. 
unstable since: 3.0 


GtkWidget::selection-notify-event 


No description available. 
unstable since: 3.0 


GtkWidget::selection-received 


No description available. 
unstable since: 3.0 
GtkWidget::selection-request-event 


The ::selection-request-event signal will be emitted when another client requests ownership of the 
selection owned by the widget ‘s window. 


unstable since: 3.0 
GtkWidget::show 
The ::show signal is emitted when widget is shown, for example with gtk_widget_show(). 
unstable since: 3.0 


GtkWidget::show-help 


No description available. 
unstable since: 3.0 


GtkWidget: :size-allocate 


No description available. 


unstable since: 3.0 

GtkWidget::state-changed 

The ::state-changed signal is emitted when the widget state changes. See gtk_widget_get_state(). 
unstable deprecated: 3.0 since: 3.0 

GtkWidget::state-flags-changed 


The ::state-flags-changed signal is emitted when the widget state changes, 
see gtk_widget_get_state_flags(). 


unstable since: 3.0 
GtkWidget::style-set 


The ::style-set signal is emitted when a new style has been set on a widget. Note that style-modifying 
functions like gtk_widget_modify_base() also cause this signal to be emitted. 


unstable deprecated: 3.0 since: 3.0 
GtkWidget::style-updated 


The ::style-updated signal is a convenience signal that is emitted when the 
GtkStyleContext: : changed signal is emitted on the widget‘s associated GtkSt yleContext 
as returned by gtk_widget_get_style_context(). 


unstable since: 3.0 


GtkWidget::touch-event 


No description available. 
unstable since: 3.0 
GtkWidget::unmap 


The ::unmap signal is emitted when widget is going to be unmapped, which means that either it or any 
of its parents up to the toplevel widget have been set as hidden. 


unstable since: 3.0 
GtkWidget::unmap-event 


The ::unmap-event signal will be emitted when the widget ‘s window is unmapped. A window is 
unmapped when it becomes invisible on the screen. 


unstable since: 3.0 
GtkWidget::unrealize 


The ::unrealize signal is emitted when the GdkWindow associated with widget is destroyed, which 
means that gtk_widget_unrealize() has been called or the widget has been unmapped (that is, it is 
going to be hidden). 


unstable since: 3.0 

GtkWidget:: visibility-notify-event 

The ::visibility-notify-event will be emitted when the widget ‘s window is obscured or unobscured. 
unstable deprecated: 3.12 since: 3.0 

GtkWidget::window-state-event 


The ::window-state-event will be emitted when the state of the toplevel window associated to the widget 
changes. 


unstable since: 3.0 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2WebViewClass { 

WebKitWebViewBaseClass parent; 

void (* load_changed) ( 
WebKitWebView* web_view, 
WebKitLoadEvent load_event 

i 

gboolean (* load_failed) ( 
WebKitWebView* web_view, 
WebKitLoadEvent load_event, 
const gchar* failing_uri, 
GError* error 

i 

GtkWidget* (* create) ( 
WebKitWebView* web_view, 
WebKitNavigationAction* navigation_action 

i 

void (* ready_to_show) ( 
WebKitWebView* web_view 

i 


void (* run_as_modal) ( 
WebKitWebView* web_view 
i 
void (* close) ( 
WebKitWebView* web_view 
\e 
gboolean (* script_dialog) ( 
WebKitWebView* web_view, 
WebKitScriptDialog* dialog 
i 
gboolean (* decide_policy) ( 
WebKitWebView* web_view, 
WebKitPolicyDecision* decision, 
WebKitPolicyDecisionType type 


i 

gboolean (* permission_request) ( 
WebKitWebView* web_view, 
WebKitPermissionRequest* permission_request 

i 

void (* mouse_target_changed) ( 
WebKitWebView* web_view, 
WebKitHitTestResult* hit_test_result, 
guint modifiers 

i 

gboolean (* print) ( 
WebKitWebView* web_view, 
WebKitPrintOperation* print_operation 


i 

void (* resource_load_started) ( 
WebKitWebView* web_view, 
WebKitWebResource* resource, 
WebKitURIRequest* request 


i 

gboolean (* enter_fullscreen) ( 
WebKitWebView* web_view 

i 

gboolean (* leave_fullscreen) ( 
WebKitWebView* web_view 

i 

gboolean (* run_file_chooser) ( 
WebKitWebView* web_view, 
WebKitFileChooserRequest* request 

i 

gboolean (* context_menu) ( 
WebKitWebView* web_view, 
WebKitContextMenu* context_menu, 
GdkEvent* event, 
WebKitHitTestResult* hit_test_result 

i 

void (* context_menu_dismissed) ( 
WebKitWebView* web_view 

i 

void (* submit_form) ( 
WebKitWebView* web_view, 
WebKitFormSubmissionRequest* request 

i 

void (* insecure_content_detected) ( 


Web 
Web 
i 


KitWebView* web_view, 
KitInsecureContentEvent event 


gboolean (* web_process_crashed) ( 


Web 
i 


KitWebView* web_view 


gboolean (* authenticate) ( 


Web 
Web 
i 


KitWebView* web_view, 
KitAuthenticationRequest* request 


gboolean (* load_failed_with_tls_errors) ( 


Web 

con 

GT1l 

GT1l 
i 


KitWebView* web_view, 

st gchar* failing_uri, 
sCertificate* certificate, 
sCertificateFlags errors 


gboolean (* show_notification) ( 


Web 
Web 
i 


KitWebView* web_view, 
KitNotification* notification 


gboolean (* run_color_chooser) ( 


Web 
Web 
i 


KitWebView* web_view, 
KitColorChooserRequest* request 


gboolean (* show_option_menu) ( 


Web 
Web 


GdkI 


Gdk 
i 
void 

Web 

Web 
i 


KitWebView* web_view, 
KitOptionMenu* menu, 
Event* event, 

Rectangle* rectangle 


(* web_process_terminated) ( 
KitWebView* web_view, 
KitWebProcessTerminationReason reason 


gboolean (* user_message_received) ( 


Web 
Web 
i 


KitWebView* web_view, 
KitUserMessage* message 


gboolean (* query_permission_state) ( 


Web 


KitWebView* web_view, 
KitPermissionStateQuery* query 


No description available. 


Class members 


parent: WebKitWebViewBaseClass 

No description available. 
load_changed: void (* load_changed) 
WebKitLoadEvent load_event ) 

No description available. 


( WebKitWebView* web_view, 


load_failed: gboolean (* load_failed) ( WebKitWebView* web_view, 
WebKitLoadEvent load_event, const gchar* failing_uri, GError* error ) 
No description available. 
create: GtkWidget* (* create) ( WebKitWebView* web_view, 
WebKitNavigationAction* navigation_action ) 
No description available. 


ready_to_show: void (* ready_to_show) ( WebKitWebView* web_view ) 
No description available. 

run_as_modal: void (* run_as_modal) ( WebKitWebView* web_view ) 
No description available. 

close: void (* close) ( WebKitWebView* web_view ) 
No description available. 

script_dialog: gboolean (* script_dialog) ( WebKitWebView* web_view, 


WebKitScriptDialog* dialog ) 

No description available. 
decide_policy: gboolean (* decide_policy) ( WebKitWebView* web_view, 
WebKitPolicyDecision* decision, WebKitPolicyDecisionType type ) 

No description available. 
permission_request: gboolean (* permission_request) ( WebKitWebView* 
web_view, WebKitPermissionRequest* permission_request ) 

No description available. 
mouse_target_changed: void (* mouse_target_changed) ( WebKitWebView* 
web_view, WebKitHitTestResult* hit_test_result, guint modifiers ) 

No description available. 
print: gboolean (* print) ( WebKitWebView* web_view, 
WebKitPrintOperation* print_operation ) 

No description available. 
resource_load_started: void (* resource_load_started) ( WebKitWebView* 
web_view, WebKitWebResource* resource, WebKitURIRequest* request ) 

No description available. 
enter_fullscreen: gboolean (* enter_fullscreen) ( WebKitWebView* 
web_view ) 

No description available. 
leave_fullscreen: gboolean (* leave_fullscreen) ( WebKitWebView* 
web_view ) 

No description available. 
run_file_chooser: gboolean (* run_file_chooser) ( WebKitWebView* 
web_view, WebKitFileChooserRequest* request ) 

No description available. 
context_menu: gboolean (* context_menu) ( WebKitWebView* web_view, 
WebKitContextMenu* context_menu, GdkEvent* event, WebKitHitTestResult* 
hit_test_result ) 

No description available. 
context_menu_dismissed: void (* context_menu_dismissed) ( 
WebKitWebView* web_view ) 

No description available. 


submit_form: void (* submit_form) ( WebKitWebView* web_view, 
WebKitFormSubmissionRequest* request ) 

No description available. 
insecure_content_detected: void (* insecure_content_detected) ( 
WebKitWebView* web_view, WebKitInsecureContentEvent event ) 

No description available. 
web_process_crashed: gboolean (* web_process_crashed) ( WebKitWebView* 
web_view ) 

No description available. 
authenticate: gboolean (* authenticate) ( WebKitWebView* web_view, 
WebKitAuthenticationRequest* request ) 

No description available. 
load_failed_with_tls_errors: gboolean (* load_failed_with_tls_errors) ( 
WebKitWebView* web_view, const gchar* failing_uri, GTlsCertificate* 
certificate, GTlsCertificateFlags errors ) 

No description available. 
show_notification: gboolean (* show_notification) ( WebKitWebView* 
web_view, WebKitNotification* notification ) 

No description available. 
run_color_chooser: gboolean (* run_color_chooser) ( WebKitWebView* 
web_view, WebKitColorChooserRequest* request ) 

No description available. 


show_option_menu: gboolean (* show_option_menu) ( WebKitWebView* 
web_view, WebKitOptionMenu* menu, GdkEvent* event, GdkRectangle* 
rectangle ) 


No description available. 
web_process_terminated: void (* web_process_terminated) ( 
WebKitWebView* web_view, WebKitWebProcessTerminationReason reason ) 
No description available. 
user_message_received: gboolean (* user_message_received) ( 
WebKitWebView* web_view, WebKitUserMessage* message ) 
No description available. 
query_permission_state: gboolean (* query_permission_state) ( 
WebKitWebView* web_view, WebKitPermissionStateQuery* query ) 
No description available. 


Virtual methods 


WebKit2.WebViewClass.authenticate 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.close 


No description available. 
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WebKit2.WebViewClass.context_menu 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.context_menu_dismissed 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.create 


No description available. 
unstable since: 4.1 


WebKit2.WebViewClass.decide_policy 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.enter_fullscreen 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.insecure_content_detected 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.leave_fullscreen 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.load_changed 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.load_failed 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.load_failed_with_tls_errors 


No description available. 
unstable since: 4.1 


WebKit2.WebViewClass.mouse_target_changed 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.permission_request 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.print 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.query_permission_state 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.ready_to_show 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.resource_load_started 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.run_as_modal 


No description available. 
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WebKit2.WebViewClass.run_color_chooser 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.run_file_chooser 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.script_dialog 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.show_notification 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.show_option_menu 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.submit_form 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.user_message_received 


No description available. 
unstable since: 4.1 


WebKit2.WebViewClass.web_process_crashed 


No description available. 


unstable since: 4.1 


WebKit2.WebViewClass.web_process_terminated 


No description available. 
unstable since: 4.1 
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Constructor 


WebKit3WebViewnew 
Declaration 


GtkWidget* 
webkit_web_view_new ( 
void 


) 


Description 


Creates a new WebKitWebView with the default WebKitWebContext. 


Creates a new WebKitWebView with the default WebKitWebContext and no 
WebKitUserContentManager associated with it. See also webkit_web_view_new_with_context(), 
webkit_web_view_new_with_user_content_manager(), and webkit_web_view_new_with_settings(). 


Return value 
Type: GtkWidget 


The newly created WebKitWebView widget. 


The data is owned by the called function. 
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Type 


Constructors 


new_with_contextInew_with_related_view|new_with_settingsJnew_with_user_content_manager 
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Constructor 


WebKit2WebViewnew_with_context 
Declaration 


GtkWidget* 

webkit_web_view_new_with_context ( 
WebKitWebContext* context 

) 


Description 


Creates a new WebKit WebView with the given WebKitWebContext. 


Creates a new WebKitWebView with the given WebKitWebContext and no 
WebKitUserContentManager associated with it. See also 
webkit_web_view_new_with_user_content_manager () 

and webkit_web_view_new_with_settings(). 


Parameters 


context 


Type:|WebKitWebContext 


The WebKitWebContext to be used by the WebKitWebView. 


The data is owned by the caller of the function. 


Return value 
Type: GtkWidget 


The newly created WebKitWebView widget. 


The data is owned by the called function. 
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Type 


Constructors 


new_with_contextInew_with_related_view|new_with_settingsJnew_with_user_content_manager 
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Constructor 


WebKit2WebViewnew_with_related_view 


since: 2.4 


Declaration 


GtkWidget * 
webkit_web_view_new_with_related_view ( 
WebKitWebView* web_view 


) 


Description 


Creates a new WebKit WebView sharing the same web process with web_view. 


This method doesn’t have any effect when 
WEBKIT_PROCESS_MODEL_SHARED_SECONDARY_PROCESS process model is used, because a 
single web process is shared for all the web views in the same WebKitWebContext. When using 
WEBKIT_PROCESS_MODEL_MULTIPLE_SECONDARY_PROCESSES process model, this method 
should always be used when creating the WebKitWebView in the WebKitWebView: : create signal. 
You can also use this method to implement other process models based on 
WEBKIT_PROCESS_MODEL_MULTIPLE_SECONDARY_PROCESSES, like for example, sharing the 
same web process for all the views in the same security domain. 


The newly created WebKitWebView will also have the same WebKitUserContentManager, 
WebKitSettings, and WebKitWebsitePolicies as web_view. 


Available since: 2.4 


Parameters 


web_view 


Type: 


The related WebKitWebView. 


The data is owned by the caller of the function. 


Return value 
Type: GtkWidget 


The newly created WebKitWebView widget. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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Constructor 


WebKit2Web Viewnew_with_settings 


since: 2.6 


Declaration 


GtkWidget* 

webkit_web_view_new_with_settings ( 
WebKitSettings* settings 

) 


Description |[src] 
Creates a new WebKitWebView with the given WebKitSettings. 


See also webkit_web_view_new_with_context(), 
and webkit_web_view_new_with_user_content_manager(). 


Available since: 2.6 


Parameters 


settings 


Type:\WebKitSettings 


A WebKitSettings. 


The data is owned by the caller of the function. 


Return value 
Type: GtkWidget 


The newly created WebKitWebView widget. 


The data is owned by the called function. 
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Constructor 


WebKit2WebViewnew_with_user_content_manager 


since: 2.6 


Declaration 


GtkWidget* 
webkit_web_view_new_with_user_content_manager ( 
WebKitUserContentManager* user_content_manager 


) 


Description 


Creates a new WebKitWebView with the given WebKitUserContentManager. 


The content loaded in the view may be affected by the content injected in the view by the user 
content manager. 


Available since: 2.6 


Parameters 


user_content_manager 


Type:|(WebKitUserContentManager 


A WebKitUserContentManager. 


The data is owned by the caller of the function. 


Return value 
Type: GtkWidget 


The newly created WebKitWebView widget. 


The data is owned by the called function. 
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Method 


WebKit2\WebViewcall_async_javascript_function 


since: 2.40 


Declaration 


void 
webkit_web_view_call_async_javascript_function ( 
WebKitWebView* web_view, 
const char* body, 
gssize length, 
GVariant* arguments, 
const char* world_name, 
const char* source_uri, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously call body with arguments in the script world with name wor1d_name of the main 
frame current context in web_view. The arguments values must be one of the following types, or 
contain only the following GVariant types: number, string and dictionary. The result of the operation can 
be a Promise that will be properly passed to the callback. If world_name is NULL, the default world is 
used. Any value that is not NULL is a distin ct world. The source_uri will be shown in exceptions and 
doesn’t affect the behavior of the script. When not provided, the document URL is used. 


Note that if WebKitSettings:enable-javascript is FALSE, this method will do nothing. If you 
want to use this method but still prevent web content from executing its own JavaScript, then use 
WebKitSettings:enable-javascript-—markup. 


When the operation is finished, callback will be called. You can then call 
webkit_web_view_call_async_javascript_function_finish () to get the result of 
the operation. 


This is an example that shows how to pass arguments to a JS function that returns a Promise that resolves 
with the passed argument: 


static void 


web_view_javascript_finished (GObject *object, 
GAsyncResult *result, 
gpointer user_data) 
{ 
JSCValue *value; 
GError *error = NULL; 
value = webkit_web_view_call_async_javascript_function_finish (WEBKIT_WEB_VIEW (object), result, &error); 
if (!value) { 
g_warning ("Error running javascript: %s", error—>message) ; 
g_error_free (error); 
return; 


} 


if (jsc_value_is_number (value)) { 


gint32 int_value = jsc_value_to_string (value); 
JSCException *exception = jsc_context_get_exception (jsc_value_get_context (value) ); 
if (exception) 
g_warning ("Error running javascript: %s", jsc_exception_get_message (exception)); 
else 
g_print ("Script result: %d\n", int_value); 
g_free (str_value); 
} else { 
g_warning ("Error running javascript: unexpected return value"); 


} 


webkit_javascript_result_unref (js_result); 


static void 
web_view_evaluate_promise (WebKitWebView *web_view) 
{ 

GVariantDict dict; 

g_variant_dict_init (&dict, NULL); 


_variant_dict_insert (&dict, "count", "u", 42); 

GVariant *args = g_variant_dict_end (&dict); 

const gchar *body = "return new Promise((resolve) => { resolve(count); });"; 

webkit_web_view_call_async_javascript_function (web_view, body, -1, arguments, NULL, NULL, NULL, web_view_javascript_finished, NULL) ; 


Available since: 2.40 


Parameters 

body 
Type: const char* 
The function body. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


length 
Type: gssize 


Length of body, or -1 if body is a nul-terminated string. 


arguments 
Type: GVariant 
A GVariant with format a{sv} storing the function arguments, or NULL. 


The argument can be NULL. 


The data is owned by the caller of the method. 


world_name 
Type: const char* 


The name of a WebKit ScriptWorld or NULL to use the default. 


The argument can be NULL. 
The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


source_uri 
Type: const char* 
The source URI. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the script finished. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2WebViewcall_async_javascript_function_finish 


since: 2.40 


Declaration 


JSCValue* 
webkit_web_view_call_async_javascript_function_finish ( 
WebKitWebView* web_view, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_web_view_call_async_javascript_function(). 


Available since: 2.40 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 

Return value 

Type: TSCValue 


A JSCValue with the return value of the async function or NULL in case of error. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2WebViewcan_execute_editing_command 


Declaration 


void 
webkit_web_view_can_execute_editing_command ( 
WebKitWebView* web_view, 
const gchar* command, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously check if it is possible to execute the given editing command. 


When the operation is finished, callback will be called. You can then call 
webkit_web_view_can_execute_editing_command_finish () to get the result of 
the operation. 


Parameters 

command 
Type: const gchar* 
The command to check. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2WebViewcan_execute_editing_command_finish 


Declaration 


gboolean 
webkit_web_view_can_execute_editing_command_finish ( 
WebKitWebView* web_view, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_web_view_can_execute_editing_command(). 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error} 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 
Type: gboolean 


TRUE if the editing command can be executed or FALSE otherwise. 
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Method 


WebKit2WebViewcan_go_back 


Declaration 


gboolean 

webkit_web_view_can_go_back ( 
WebKitWebView* web_view 

) 


Description 


Determines whether web_view has a previous history item. 
Return value 
Type: gboolean 


TRUE if able to move back or FALSE otherwise. 
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Method 


WebKit2WebViewcan_go_forward 


Declaration 


gboolean 

webkit_web_view_can_go_forward ( 
WebKitWebView* web_view 

) 


Description 


Determines whether web_view has a next history item. 
Return value 
Type: gboolean 


TRUE if able to move forward or FALSE otherwise. 
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Method 


WebKit2WebViewran_show_mime_type 


Declaration 


gboolean 
webkit_web_view_can_show_mime_type ( 
WebKitWebView* web_view, 
const gchar* mime_type 


) 


Description 
Whether or not a MIME type can be displayed in web_view. 
Parameters 
mime_type 
Type: const gchar* 
A MIME type. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gboolean 


TRUE if the MIME type mime_type can be displayed or FALSE otherwise. 
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Method 


WebKit2Web Viewdownload_uri 


Declaration 


WebKitDownload* 

webkit_web_view_download_uri ( 
WebKitWebView* web_view, 
const char* uri 


) 


Description 


Requests downloading of the specified URI string for web_view. 


Parameters 
uri 
Type: const char* 


The URI to download. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitDownload 


A new WebKitDown1load representing the download operation. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2\WebViewevaluate_javascript 


since: 2.40 


Declaration 


void 
webkit_web_view_evaluate_javascript ( 
WebKitWebView* web_view, 
const char* script, 
gssize length, 
const char* world_name, 
const char* source_uri, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously evaluate script in the script world with name world_name of the main frame current 
context in web_view. If world_name is NULL, the default world is used. Any value that is not NULL is 
a distinct world. The source_uri will be shown in exceptions and doesn’t affect the behavior of the 
script. When not provided, the document URL is used. 


Note that if WebKitSettings:enable-javascript is FALSE, this method will do nothing. If you 
want to use this method but still prevent web content from executing its own JavaScript, then use 
WebKitSettings:enable-javascript-—markup. 


When the operation is finished, callback will be called. You can then call 
webkit_web_view_evaluate_javascript_finish() to get the result of the operation. 


This is an example of using webkit_web_view_evaluate_javascript () with a script returning 
a string: 


static void 


web_view_javascript_finished (GObject *object, 
GAsyncResult *result, 
gpointer user_data) 
{ 
JSCValue *value; 
GError *error = NULL; 


value = webkit_web_view_evaluate_javascript_finish (WEBKIT_WEB_VIEW (object), result, &error); 
if (!value) { 

g_warning ("Error running javascript: %s", error-—>message) ; 

g_error_free (error); 


return; 
} 
if (jsc_value_is_string (value)) { 
gchar *str_value = jsc_value_to_string (value); 
JSCException *exception = jsc_context_get_exception (jsc_value_get_context (value) ); 


if (exception) 
g_warning ("Error running javascript: %s", jsc_exception_get_message (exception) ); 


else 
g_print ("Script result: %s\n", str_value); 
g_free (str_value); 
} else { 


g_warning ("Error running javascript: unexpected return value"); 
} 
webkit_javascript_result_unref (js_result); 


} 


static void 
web_view_get_link_url (WebKitWebView *web_view, 


const gchar *link_id) 


gchar *script = g_strdup_printf ("window.document.getElementById(’%s’).href;", link_id); 


webkit_web_view_evaluate_javascript (web_view, script, -1, NULL, NULL, NULL, web_view_javascript_finished, NULL); 


g_free (script); 


Available since: 2.40 


Parameters 

script 
Type: const char* 
The script to evaluate. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


length 
Type: gssize 


Length of script, or-lif script is a nul-terminated string. 


world_name 
Type: const char* 
The name of a WebKit ScriptWorld or NULL to use the default. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


source_uri 
Type: const char* 


The source URI. 


The argument can be NULL. 
The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the script finished. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2\WebViewevaluate_javascript_finish 


since: 2.40 


Declaration 


JSCValue* 
webkit_web_view_evaluate_javascript_finish ( 
WebKitWebView* web_view, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_web_view_evaluate_javascript(). 


Available since: 2.40 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 

Return value 

Type: TSCValue 


A JSCValue with the result of the last executed statement in script or NULL in case of error. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2WebViewexecute_editing_command 


Declaration 


void 
webkit_web_view_execute_editing_command ( 
WebKitWebView* web_view, 
const gchar* command 


) 


Description 


Request to execute the given command for web_view. 


You can use webkit_web_view_can_execute_editing_command () to check whether it’s 
possible to execute the command. 


Parameters 

command 
Type: const gchar* 
The command to execute. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2|WebViewexecute_editing_command_with_argument 


since: 2.10 


Declaration 


void 
webkit_web_view_execute_editing_command_with_argument ( 
WebKitWebView* web_view, 
const char* command, 
const char* argument 


) 


Description 


Request to execute the given command with argument for web_view. 


You can use webkit_web_view_can_execute_editing_command () to check whether it’s 
possible to execute the command. 


Available since: 2.10 


Parameters 

command 
Type: const char* 
The command to execute. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


argument 
Type: const char* 
The command argument. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2WebViewget_automation_presentation_type 


since: 2.28 


Declaration 


WebKitAutomationBrowsingContextPresentation 

webkit_web_view_get_automation_presentation_type ( 
WebKitWebView* web_view 

) 


Description 


Get the presentation type of WebKitWebView when created for automation. 


Available since: 2.28 


Gets property |WebKit2.WebView:automation-presentation-type 


Return value 


Type: |WebKitAutomationBrowsingContextPresentation 


A WebKitAutomationBrowsingContextPresentation. 
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Method 


WebKit2\WebViewget_back_forward_list 


Declaration 


WebKitBackForwardList* 

webkit_web_view_get_back_forward_list ( 
WebKitWebView* web_view 

) 


Description 


Obtains the WebKitBackForwardList associated with the given WebKitWebView. 


The WebKitBackForwardList is owned by the WebKitWebView. 


Return value 


Type: |WebKitBackForwardList 


The WebKitBackForwardList. 


The data is owned by the instance. 
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Method 


WebKit2WebViewget_background_color 


since: 2.8 


Declaration 


void 
webkit_web_view_get_background_color ( 
WebKitWebView* web_view, 
GdkRGBA* rgba 
) 


Description 


Gets the color that is used to draw the web_view background. 


Gets the color that is used to draw the web_view background before the actual contents are rendered. For 
more information see also webkit_web_view_set_background_color () 


Available since: 2.8 
Parameters 
rgba 
Type: GAKRGBA 
A GdkRGBA to fill in with the background color. 


The argument will be set by the function. 


The data is owned by the instance. 
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Method 


WebKit2WebViewget_camera_capture_state 


since: 2.34 


Declaration 


WebKitMediaCaptureState 

webkit_web_view_get_camera_capture_state ( 
WebKitWebView* web_view 

) 


Description 


Get the camera capture state of aWebKitWebView. 


Available since: 2.34 


Gets property |WebKit2.WebView:camera-capture-state 


Return value 


Type: |WebKitMediaCaptureState 


The WebKitMediaCaptureState of the camera device. If 
WebKitSettings:enable-mediastream is FALSE, this method will return 
WEBKIT_MEDIA_CAPTURE_STATE_NONE. 
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Method 


WebKit2Web Viewget_context 


Declaration 


WebKitWebContext* 
webkit_web_view_get_context ( 
WebKitWebView* web_view 

) 


Description 


Gets the web context of web_view. 


Return value 


Type: |WebKitWebContext 


The WebKitWebContext of the view. 


The data is owned by the instance. 
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Method 


WebKit2WebViewget_custom_charset 


Declaration 


const gchar* 

webkit_web_view_get_custom_charset ( 
WebKitWebView* web_view 

) 


Description 


Returns the current custom character encoding name of web_view. 
Return value 
Type: const gchar* 


The current custom character encoding name or NULL if no custom character encoding has been set. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2WebViewget_default_content_security_policy 


since: 2.38 


Declaration 


const gchar* 

webkit_web_view_get_default_content_security_policy ( 
WebKitWebView* web_view 

) 


Description 


Gets the configured default Content-Security-Policy. 


Available since: 2.38 


Gets property |WebKit2.WebView:default—content-—security-policy 


Return value 
Type: const gchar* 
The default policy or NULL. 
The data is owned by the instance. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2WebViewget_display_capture_state 


since: 2.34 


Declaration 


WebKitMediaCaptureState 

webkit_web_view_get_display_capture_state ( 
WebKitWebView* web_view 

) 


Description 


Get the display capture state of aWebKitWebView. 


Available since: 2.34 


Gets property |WebKit2.WebView:display-—capture-state 


Return value 


Type: |WebKitMediaCaptureState 


The WebKitMediaCaptureState of the display device. If 
WebKitSettings:enable-mediastream is FALSE, this method will return 
WEBKIT_MEDIA_CAPTURE_STATE_NONE. 
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Method 


WebKit2Web Viewget_editor_state 


since: 2.10 


Declaration 


WebKitEditorState* 

webkit_web_view_get_editor_state ( 
WebKitWebView* web_view 

) 


Description 


Gets the web editor state of web_view. 


Available since: 2.10 


Return value 


Type: |WebKitEditorState 


The WebKitEditorState of the view. 


The data is owned by the instance. 
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Method 


WebKit2WebViewget_estimated_load_progress 


Declaration 


gdouble 

webkit_web_view_get_estimated_load_progress ( 
WebKitWebView* web_view 

) 


Description 


Gets the value of the WebKitWebView:estimated-load-progress property. 


You can monitor the estimated progress of a load operation by connecting to the 
notify::estimated-load-progress signal of web_view. 


Gets property |WebKit2.WebView:estimated-load-progress 


Return value 
Type: gdouble 


An estimate of the of the percent complete for a document load as a range from 0.0 to 1.0. 
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Method 


WebKit{Web Viewget_favicon 


Declaration 


cairo_surface_t* 

webkit_web_view_get_favicon ( 
WebKitWebView* web_view 

) 


Description 


Returns favicon currently associated to web_view. 


Returns favicon currently associated to web_view, if any. You can connect to notify::favicon signal of 
web_view to be notified when the favicon is available. 


Gets property |WebKit2.WebView: favicon 


Return value 
Type: cairo_surface_t 


The favicon image or NULL if there’s no icon associated with web_view. 


The data is owned by the instance. 
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Method 


WebKit2WebViewget_find_controller 


Declaration 


WebKitFindController* 

webkit_web_view_get_find_controller ( 
WebKitWebView* web_view 

) 


Description 


Gets the WebKitFindController. 


Gets the WebKitFindController that will allow the caller to query the WebKitWebView for the 
text to look for. 


Return value 


Type: |WebKitFindController 


The WebKitFindController associated to this particular WebKitWebView. 


The data is owned by the instance. 
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Method 


WebKit2\WebViewget_input_method_context 


since: 2.28 


Declaration 


WebKit InputMethodContext* 

webkit_web_view_get_input_method_context ( 
WebKitWebView* web_view 

) 


Description 


Get the WebKit InputMethodContext currently in use by web_view. 


Get the WebKit InputMethodContext currently in use by web_view, or NULL if no input method 
is being used. 


Available since: 2.28 


Return value 


Type: |WebKitInputMethodContext 


A WebKit InputMethodContext, or NULL. 


The data is owned by the instance. 


The return value can be NULL. 
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Method 


WebKit{WebViewget_inspector 


Declaration 


WebKitWebInspector* 

webkit_web_view_get_inspector ( 
WebKitWebView* web_view 

) 


Description 


Get the WebKitWebInspector associated to web_view. 


Return value 


Type:|WebKitWebInspector 


The WebKitWebInspector of web_view. 


The data is owned by the instance. 
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Method 


WebKit2WebViewget_is_muted 


since: 2.30 


Declaration 


gboolean 

webkit_web_view_get_is_muted ( 
WebKitWebView* web_view 

) 


Description 


Gets the mute state of web_view. 


Available since: 2.30 


Gets property |WebKit2.WebView:is—muted 


Return value 
Type: gboolean 


TRUE if web_view audio is muted or FALSE is audio is not muted. 
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Method 


WebKit2\WebViewget_is_web_process_responsive 


since: 2.34 


Declaration 


gboolean 

webkit_web_view_get_is_web_process_responsive ( 
WebKitWebView* web_view 

) 


Description 


Get whether the current web process of a WebKitWebView is responsive. 


Available since: 2.34 


Gets property |WebKit2.WebView:is—web-process-—responsive 


Return value 
Type: gboolean 


TRUE if the web process attached to web_view is responsive, or FALSE otherwise. 
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Method 


WebKit2WebViewget_javascript_global_context 


deprecated: 2.22 


Declaration 


JSGlobalContextRef 

webkit_web_view_get_javascript_global_context ( 
WebKitWebView* web_view 

) 


Description 


Get the global JavaScript context. 


Get the global JavaScript context used by web_view to deserialize the result values of scripts executed 
with webkit_web_view_run_javascript(). 


Deprecated since: 2.22 


Use jsc_value_get_context () instead. 


This method is not directly available to language bindings. 
Return value 
Type: TSGlobalContextRef 


The JSGlobalContextRef used by web_view to deserialize the result values of scripts. 
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Method 


WebKit2WebViewget_main_resource 


Declaration 


WebKitWebResource* 

webkit_web_view_get_main_resource ( 
WebKitWebView* web_view 

) 


Description 


Return the main resource of web_ view. 


Return value 


Type: |WebKitWebResource 


The main WebKitWebResource of the view or NULL if nothing has been loaded. 


The data is owned by the instance. 
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Method 


WebKit2WebViewget_microphone_capture_state 


since: 2.34 


Declaration 


WebKitMediaCaptureState 

webkit_web_view_get_microphone_capture_state ( 
WebKitWebView* web_view 

) 


Description 


Get the microphone capture state of aWebKitWebView. 


Available since: 2.34 


Gets property |WebKit2.WebView:microphone-capture-state 


Return value 


Type: |WebKitMediaCaptureState 


The WebKitMediaCaptureState of the microphone device. If 
WebKitSettings:enable-mediastream is FALSE, this method will return 
WEBKIT_MEDIA_CAPTURE_STATE_NONE. 
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Method 


WebKit2WebViewget_page_id 


Declaration 


guint64 

webkit_web_view_get_page_id ( 
WebKitWebView* web_view 

) 


Description 


Get the identifier of the WebKitWebPage corresponding to the WebKitWebView. 


Gets property |WebKit2.WebView:page-id 


Return value 
Type: guint 64 


The page ID of web_view. 
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Method 


WebKit2|WebViewget_session_state 


since: 2.12 


Declaration 


WebKitWebViewSessionState* 

webkit_web_view_get_session_state ( 
WebKitWebView* web_view 

) 


Description 


Gets the current session state of web_view. 


Available since: 2.12 


Return value 


Type: |WebKitWebViewSessionState 


A WebKitWebViewSessionState. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2Web Viewget_settings 


Declaration 


WebKitSettings* 

webkit_web_view_get_settings ( 
WebKitWebView* web_view 

) 


Description 


Gets the WebKitSettings currently applied to web_view. 


If no other WebKit Settings have been explicitly applied to web_view with 
webkit_web_view_set_settings(), the default WebKitSettings will be returned. This method always 
returns a valid WebKitSettings object. To modify any of the web_view settings, you can either 
create anew WebKitSettings object with webkit_settings_new(, setting the desired preferences, and 
then replace the existing web_view settings with webkit_web_view_set_settings () or get the 
existing web_view settings and update it directly. WebKit Settings objects can be shared by multiple 
WebKitWebViews, so modifying the settings of aWebKitWebView would affect other 
WebKitWebViews using the same WebKitSettings. 


Return value 


Type:|WebKitSettings 


The WebKitSettings attached to web_view. 


The data is owned by the instance. 
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Method 


WebKit2W eb Viewget_snapshot 


Declaration 


void 

webkit_web_view_get_snapshot ( 
WebKitWebView* web_view, 
WebKitSnapshotRegion region, 
WebKitSnapshotOptions options, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously retrieves a snapshot of web_view for region. 


options specifies how the snapshot should be rendered. 


When the operation is finished, callback will be called. You must call 
webkit_web_view_get_snapshot_finish () to get the result of the operation. 


Parameters 
region 


Type: |WebKitSnapshotRegion 


The WebKit SnapshotRegion for this snapshot. 


options 


Type:\WebKitSnapshotOptions 


WebKit SnapshotOptions for the snapshot. 


cancellable 
Type: GCancellable 
A GCancellable. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback. 


The argument can be NULL. 


user_data 
Type: gpointer 
User data. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Methods 
call_async_javascript_function}call_async_javascript_function_finish}can_execute_editing_ command 


can_execute_editing command_finish}can_go_backjcan_go_forwardjcan_show_mime_type 


Generated by[gi-docgen|2023.3 
Method 


WebKit2\WebViewget_snapshot_finish 


Declaration 


cairo_surface_t* 
webkit_web_view_get_snapshot_finish ( 
WebKitWebView* web_view, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finishes an asynchronous operation started with webkit_web_view_get_snapshot(). 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error} 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 
Type: cairo_surface_t 


An image with the retrieved snapshot, or NULL in case of error. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Library Version: 2.42.4 
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Method 


WebKit2Web Viewget_title 


Declaration 


const gchar* 

webkit_web_view_get_title ( 
WebKitWebView* web_view 

) 


Description 


Gets the value of the WebKitWebView: title property. 


You can connect to notify::title signal of web_view to be notified when the title has been received. 


Gets property |WebKit2.WebView:title 


Return value 
Type: const gchar* 
The main frame document title of web_view. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2Web Viewget_tls_info 


Declaration 


gboolean 

webkit_web_view_get_tls_info ( 
WebKitWebView* web_view, 
GTlsCertificate** certificate, 
GTlsCertificateFlags* errors 


) 


Description 


Retrieves the GTlsCertificate associated with the main resource of web_view. 


Retrieves the GTlsCertificate associated with the main resource of web_view, and the 
GTlsCertificateFlags showing what problems, if any, have been found with that certificate. If the 
connection is not HTTPS, this function returns FALSE. This function should be called after a response has 
been received from the server, so you can connect to WebKitWebView: : load-changed and call this 
function when it’s emitted with WEBKIT_LOAD_ COMMITTED event. 


Note that this function provides no information about the security of the web page if the current 

WebKit TLSErrorsPolicy is WEBKIT_TLS_ERRORS_POLICY_IGNORE, as subresources of the 
page may be controlled by an attacker. This function may safely be used to determine the security status of 
the current page only if the current WebKit TLSErrorsPolicy is 
WEBKIT_TLS_ERRORS_POLICY_FATL, in which case subresources that fail certificate verification 
will be blocked. 


Parameters 
certificate 
Type: GTlsCertificate 
Return location fora GTlsCertificate. 


The argument will be set by the function. 


The data is owned by the instance. 


errors 
Type: GTlsCertificateFlags 
Return location fora GTlsCertificateFlags the verification status of certificate. 


The argument will be set by the function. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


Return value 
Type: gboolean 


TRUE if the web_view connection uses HTTPS and a response has been received from the server, or 
FALSE otherwise. 
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Method 


WebKit2Web Viewget_uri 


Declaration 


const gchar* 
webkit_web_view_get_uri ( 

WebKitWebView* web_view 
) 


Description 


Returns the current active URI of web_view. 
The active URI might change during a load operation: 


When nothing has been loaded yet on web_view the active URI is NULL. When a new load operation 
starts the active URI is the requested URI: If the load operation was started by 
webkit_web_view_load_uri(), the requested URI is the given one. If the load operation was started by 
webkit_web_view_load_html(), the requested URI is “about:blank”’. If the load operation was started by 
webkit_web_view_load_alternate_html(), the requested URI is content URI provided. If the load operation 
was started by webkit_web_view_go_back () or webkit_web_view_go_forward(), the requested 
URI is the original URI of the previous/next item in the WebKitBackForwardList of web_view. If 
the load operation was started by webkit_web_view_go_to_back_forward_list_item(), the requested URI 
is the opriginal URI of the given WebKitBackForwardListItem. If there is a server redirection 
during the load operation, the active URI is the redirected URI. When the signal 

WebKitWebView: : load-changed is emitted with WEBKIT_LOAD_REDIRECTED event, the active 
URI is already updated to the redirected URI. When the signal WebKitWebView: : load-changed is 
emitted with WEBKIT_LOAD_ COMMITTED event, the active URI is the final one and it will not change 
unless a new load operation is started or a navigation action within the same page is performed. 


You can monitor the active URI by connecting to the notify::uri signal of web_view. 


Gets property |WebKit2.WebView:uri 


Return value 
Type: const gchar* 
The current active URI of web_view or NULL if nothing has been loaded yet. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2WebViewget_user_content_manager 


since: 2.6 


Declaration 


WebKitUserContentManager* 

webkit_web_view_get_user_content_manager ( 
WebKitWebView* web_view 

) 


Description 


Gets the user content manager associated to web_view. 


Available since: 2.6 


Gets property |WebKit2.WebView:user-content—manager 


Return value 


Type: |WebKitUserContentManager 


The WebKitUserContentManager associated with the view. 


The data is owned by the instance. 
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Method 


WebKit2WebViewget_web_extension_mode 


since: 2.38 


Declaration 


WebKitWebExtensionMode 

webkit_web_view_get_web_extension_mode ( 
WebKitWebView* web_view 

) 


Description 


Get the view’s WebKitWebExtensionMode. 


Available since: 2.38 


Gets property |WebKit2.WebView:web-extension-—mode 


Return value 


Type: |WebKitWebExtensionMode 


The WebKitWebExtensionMode. 
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Method 


WebKit2Web Viewget_website_data_manager 


since: 2.16 


Declaration 


WebKitWebsiteDataManager* 

webkit_web_view_get_website_data_manager ( 
WebKitWebView* web_view 

) 


Description 


Get the WebKitWebsiteDataManager associated to web_view. 


If web_view is not ephemeral, the returned WebKitWebsiteDataManager will be the same as the 
WebKitWebsiteDataManager of web_view‘s WebKitWebContext. 


Available since: 2.16 


Return value 


Type: |WebKitWebsiteDataManager 


A WebKitWebsiteDataManager. 


The data is owned by the instance. 
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Method 


WebKit2WebViewget_website_policies 


since: 2.30 


Declaration 


WebKitWebsitePolicies* 

webkit_web_view_get_website_policies ( 
WebKitWebView* web_view 

) 


Description 


Gets the default website policies. 


Gets the default website policies set on construction in the web_view. These can be overridden on a 
per-origin basis via the WebKitWebView: :decide-policy signal handler. 


See also webkit_policy_decision_use_with_policies(). 


Available since: 2.30 


Gets property |WebKit2.WebView:website-policies 


Return value 


Type: |WebKitWebsitePolicies 


The default WebKitWebsitePolicies associated with the view. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
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Method 


WebKit2WebViewget_window_properties 


Declaration 


WebKitWindowProperties* 

webkit_web_view_get_window_properties ( 
WebKitWebView* web_view 

) 


Description 


Get the WebKitWindowProperties object. 


Get the WebKitWindowProperties object containing the properties that the window containing 
web _view should have. 


Return value 


Type: |WebKitWindowProperties 


The WebKitWindowProperties of web_view. 


The data is owned by the instance. 
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WebKit2WebViewget_zoom_level 


Declaration 


gdouble 

webkit_web_view_get_zoom_level ( 
WebKitWebView* web_view 

) 


Description 


Set the zoom level of web_view. 


Get the zoom level of web_view, i.e. the factor by which the view contents are scaled with respect to 
their original size. 


Gets property |WebKit2.WebView: zoom-level 


Return value 
Type: gdouble 


The current zoom level of web_view. 
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Method 


WebKit2WebViewgo_back 


Declaration 


void 
webkit_web_view_go_back ( 

WebKitWebView* web_view 
) 


Description 


Loads the previous history item. 


You can monitor the load operation by connecting to WebKitWebView: : load-changed signal. 
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Method 


WebKit2WebViewgo_forward 


Declaration 


void 

webkit_web_view_go_forward ( 
WebKitWebView* web_view 

) 


Description 


Loads the next history item. 


You can monitor the load operation by connecting to WebKitWebView: : load-changed signal. 
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Method 


WebKit2WebViewgo_to_back_forward_list_item 


Declaration 


void 

webkit_web_view_go_to_back_forward_list_item ( 
WebKitWebView* web_view, 
WebKitBackForwardListItem* list_item 

) 


Description 


Loads the specific history item list_item. 


You can monitor the load operation by connecting to WebKitWebView: : load-changed signal. 


Parameters 
list_item 


Type: \WebKitBackForwardListItem 


A WebKitBackForwardListItem. 


The data is owned by the caller of the method. 
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Method 


WebKit2WebViewis_controlled_by_automation 


since: 2.18 


Declaration 


gboolean 

webkit_web_view_is_controlled_by_automation ( 
WebKitWebView* web_view 

) 


Description 


Get whether a WebKit WebView was created with 
WebKitWebView: is—controlled—by-—automation property enabled. 


Only WebKitWebViews controlled by automation can be used in an automation session. 
Available since: 2.18 

Return value 

Type: gboolean 


TRUE if web_view is controlled by automation, or FALSE otherwise. 
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Method 


WebKit2Web Viewis_editable 


since: 2.8 


Declaration 


gboolean 

webkit_web_view_is_editable ( 
WebKitWebView* web_view 

) 


Description 


Gets whether the user is allowed to edit the HTML document. 


When web_view is not editable an element in the HTML document can only be edited if the 
CONTENTEDITABLE attribute has been set on the element or one of its parent elements. By default a 
WebKitWebView is not editable. 


Available since: 2.8 
Return value 
Type: gboolean 


TRUE if the user is allowed to edit the HTML document, or FALSE otherwise. 
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Method 


WebKit2WebViewis_ephemeral 


since: 2.16 


Declaration 


gboolean 

webkit_web_view_is_ephemeral ( 
WebKitWebView* web_view 

) 


Description 


Get whether a WebKit WebView is ephemeral. 


To create an ephemeral WebKitWebView you need to use g_object_new () and pass is-ephemeral 
property with TRUE value. See WebKitWebView: is-ephemeral for more details. If web_view 
was created with a ephemeral WebKitWebView: related-view or an ephemeral 
WebKitWebView: web-context it will also be ephemeral. 


Available since: 2.16 
Return value 
Type: gboolean 


TRUE if web_view is ephemeral or FALSE otherwise. 
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Method 


WebKit2Web Viewis_loading 


Declaration 


gboolean 

webkit_web_view_is_loading ( 
WebKitWebView* web_view 

) 


Description 


Gets the value of the WebKitWebView: is—loading property. 


You can monitor when a WebKit WebView is loading a page by connecting to notify::is-loading signal of 
web_view. This is useful when you are interesting in knowing when the view is loading something but 
not in the details about the status of the load operation, for example to start a spinner when the view is 
loading a page and stop it when it finishes. 


Gets property |WebKit2.WebView:is-—loading 


Return value 
Type: gboolean 


TRUE if web_view is loading a page or FALSE otherwise. 
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Method 


WebKit2Web Viewis_playing_audio 


since: 2.8 


Declaration 


gboolean 

webkit_web_view_is_playing_audio ( 
WebKitWebView* web_view 

) 


Description 


Gets the value of the WebKitWebView: is-playing-—audio property. 
You can monitor when a page in a WebKitWebView is playing audio by connecting to the 
notify::is-playing-audio signal of web_view. This is useful when the application wants to provide visual 


feedback when a page is producing sound. 


Available since: 2.8 
Gets property |WebKit2.WebView:is—playing-—audio 


Return value 
Type: gboolean 


TRUE if a page in web_view is playing audio or FALSE otherwise. 
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Method 


WebKit2WebViewload_alternate_html 


Declaration 


void 
webkit_web_view_load_alternate_html ( 
WebKitWebView* web_view, 
const gchar* content, 
const gchar* content_uri, 
const gchar* base_uri 


Description 


Load the given content string for the URI content_uri. 


This allows clients to display page-loading errors in the WebKitWebView itself. When this method is 
called from WebKitWebView: : load-failed signal to show an error page, then the back-forward list 
is Maintained appropriately. For everything else this method works the same way 

as webkit_web_view_load_html(). 


Parameters 
content 
Type: const gchar* 
The new content to display as the main page of the web_view. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


content_uri 
Type: const gchar* 
The URI for the alternate page content. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


base_uri 
Type: const gchar* 


The base URI for relative locations or NULL. 


The argument can be NULL. 
The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 
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Method 


WebKit2WebViewload_bytes 


since: 2.6 


Declaration 


void 
webkit_web_view_load_bytes ( 
WebKitWebView* web_view, 
GBytes* bytes, 
const gchar* mime_type, 
const gchar* encoding, 
const gchar* base_uri 


Description 


Load the specified bytes into web_view using the given mime_t ype and encoding. 


When mime_type is NULL, it defaults to “text/html”. When encoding is NULL, it defaults to 
“UTF-8”. When base_uri is NULL, it defaults to “about:blank”. You can monitor the load operation by 
connecting to WebKitWebView: : load-changed signal. 


Available since: 2.6 
Parameters 
bytes 
Type: GBytes 
Input data to load. 


The data is owned by the caller of the method. 


mime_type 
Type: const gchar* 
The MIME type of bytes, or NULL. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


encoding 


Type: const gchar* 


The character encoding of bytes, or NULL. 


The argument can be NULL. 
The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


base_uri 
Type: const gchar* 
The base URI for relative locations or NULL. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 
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Method 


WebKit2Web Viewload_html 


Declaration 


void 

webkit_web_view_load_html ( 
WebKitWebView* web_view, 
const gchar* content, 
const gchar* base_uri 


) 


Description 


Load the given content string with the specified base_uri. 


If base_uri is not NULL, relative URLs in the content will be resolved against base_uri and 
absolute local paths must be children of the base_uri. For security reasons absolute local paths that are 
not children of base_uri will cause the web process to terminate. If you need to include URLs in 
content that are local paths in a different directory than base_uri you can build a data URI for them. 
When base_uri is NULL, it defaults to “about:blank”. The mime type of the document will be 
“text/html”. You can monitor the load operation by connecting to WebKitWebView: : load-changed 
signal. 


Parameters 

content 
Type: const gchar* 
The HTML string to load. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


base_uri 
Type: const gchar* 
The base URI for relative locations or NULL. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2WebViewload_plain_text 


Declaration 


void 
webkit_web_view_load_plain_text ( 
WebKitWebView* web_view, 
const gchar* plain_text 


) 


Description 


Load the specified plain_text string into web_view. 


The mime type of document will be “text/plain”. You can monitor the load operation by connecting to 
WebKitWebView: : load-changed signal. 


Parameters 
plain_text 
Type: const gchar* 
The plain text to load. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2Web Viewload_request 


Declaration 


void 

webkit_web_view_load_request ( 
WebKitWebView* web_view, 
WebKitURIRequest* request 

) 


Description 


Requests loading of the specified WebKitURIRequest. 


You can monitor the load operation by connecting to WebKitWebView: : load-changed signal. 


Parameters 


request 


Type:|WebKitURIRequest 


A WebKitURIRequest to load. 


The data is owned by the caller of the method. 
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Method 


WebKit2Web Viewload_uri 


Declaration 


void 

webkit_web_view_load_uri ( 
WebKitWebView* web_view, 
const gchar* uri 


) 


Description 


Requests loading of the specified URI string. 
You can monitor the load operation by connecting to WebKitWebView 
Parameters 
uri 
Type: const gchar* 
An URI string. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


: : Lload-changed signal. 
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Method 


WebKit2Web Viewreload 


Declaration 


void 
webkit_web_view_reload ( 

WebKitWebView* web_view 
) 


Description 


Reloads the current contents of web_view. 


See also webkit_web_view_reload_bypass_cache(). 
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Method 


WebKit2WebViewreload_bypass_cache 


Declaration 


void 

webkit_web_view_reload_bypass_cache ( 
WebKitWebView* web_view 

) 


Description 


Reloads the current contents of web_view without using any cached data. 
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Method 


WebKit2WebViewrestore_session_state 


since: 2.12 


Declaration 


void 

webkit_web_view_restore_session_state ( 
WebKitWebView* web_view, 
WebKitWebViewSessionState* state 

) 


Description 


Restore the web_view session state from state. 


Available since: 2.12 


Parameters 


state 


Type:|WebKitWebViewSessionState 


A WebKitWebViewSessionState. 


The data is owned by the caller of the method. 
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Method 


WebKit2WebViewrun_async_javascript_function_in_world 


deprecated: 2.40 since: 2.38 


Declaration 


void 
webkit_web_view_run_async_javascript_function_in_world ( 

WebKitWebView* web_view, 

const gchar* body, 

GVariant* arguments, 

const char* world_name, 

GCancellable* cancellable, 

GAsyncReadyCallback callback, 

gpointer user_data 


Description 


Asynchronously run body in the script world with name wor1d_name of the current page context in 
web_view. If WebKitSettings:enable-javascript is FALSE, this method will do nothing. This API differs 
from webkit_web_view_run_javascript_in_world() in that the JavaScript function can 
return a Promise and its result will be properly passed to the callback. 


When the operation is finished, callback will be called. You can then call 
webkit_web_view_run_javascript_in_world_finish () to get the result of the operation. 


For instance here is a dummy example that shows how to pass arguments to a JS function that returns a 
Promise that resolves with the passed argument: 


static void 


web_view_javascript_finished (GObject *object, 
GAsyncResult *result, 
gpointer user_data) 


WebKitJavascriptResult *js_result; 
JSCValue *value; 
GError *error = NULL; 


js_result = webkit_web_view_run_javascript_finish (WEBKIT_WEB_VIEW (object), result, &error); 
if (!js_result) { 


g_warning ("Error running javascript: %s", error->message) ; 
g_error_free (error); 
return; 


} 


value = webkit_javascript_result_get_js_value (js_result); 


if (jsc_value_is_number (value)) { 
gint32 int_value = jsc_value_to_string (value); 
JSCException *exception = jsc_context_get_exception (jsc_value_get_context (value) ); 


if (exception) 
g_warning ("Error running javascript: %s", jsc_exception_get_message (exception) ); 
else 
g_print ("Script result: %d\n", int_value); 
g_free (str_value) ; 
} else { 
g_warning ("Error running javascript: unexpected return value"); 
} 
webkit_javascript_result_unref (js_result); 


} 


static void 
web_view_evaluate_promise (WebKitWebView *web_view) 
{ 
GVariantDict dict; 
g_variant_dict_init (&dict, NULL); 
g_variant_dict_insert (&dict, "count", "u", 42); 
GVariant *args = g_variant_dict_end (&dict); 
const gchar *body = "return new Promise((resolve) => { resolve(count); });"% 
webkit_web_view_run_async_javascript_function_in_world (web_view, body, arguments, NULL, NULL, web_view_javascript_finished, NULL); 


Available since: 2.38 
Deprecated since: 2.40 


Use webkit_web_view_call_async_javascript_function() instead. 


Parameters 
body 
Type: const gchar* 
The JavaScript function body. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


arguments 
Type: GVariant 


A GVariant with format {&sv} storing the function arguments. Function argument values must be 
one of the following types, or contain only the following GVariant types: number, string, array, and 
dictionary. wor1d_name (nullable): the name of a WebKit ScriptWorl1d, if no name (i.e. NULL) 
is provided, the default world is used. Any value that is not NULL is a distinct world. 


The data is owned by the caller of the method. 


world_name 
Type: const char* 
No description available. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


cancellable 
Type: GCancellable 


A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the script finished. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit {Web Viewrun_javascript 


deprecated: 2.40 


Declaration 


void 
webkit_web_view_run_javascript ( 
WebKitWebView* web_view, 
const gchar* script, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously run script in the context of the current page in web_view. 
If WebKitSettings:enable-javascript is FALSE, this method will do nothing. 


When the operation is finished, callback will be called. You can then call 
webkit_web_view_run_javascript_finish () to get the result of the operation. 


Deprecated since: 2.40 
Use webkit_web_view_evaluate_javascript () instead. 
Parameters 
script 
Type: const gchar* 
The script to run. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


cancellable 
Type: GCancellable 


A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 


Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the script finished. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2WebViewrun_javascript_finish 


deprecated: 2.40 


Declaration 


WebKitJavascriptResult* 
webkit_web_view_run_javascript_finish ( 
WebKitWebView* web_view, 
GAsyncResult* result, 
GError** error 


Description 


Finish an asynchronous operation started with webkit_web_view_run_javascript(). 


This is an example of using webkit_web_view_run_javascript () witha script returning 


a string: 


static void 


web_view_javascript_finished (GObject *object, 
GAsyncResult *result, 
gpointer user_data) 


WebKitJavascriptResult *js_result; 
JSCValue *value; 
GError *error = NULL; 


js_result = webkit_web_view_run_javascript_finish (WEBKIT_WEB_VIEW (object), result, &error); 


if (!4js_result) { 
g_warning ("Error running javascript: %s", error->message) ; 
g_error_free (error); 
return; 


value = webkit_javascript_result_get_js_value (js_result); 
if (jsc_value_is_string (value)) { 
gchar *str_value = jsc_value_to_string (value); 


JSCException *exception = jsc_context_get_exception (jsc_value_get_context 


if (exception) 


(value) ); 


g_warning ("Error running javascript: %s", jsc_exception_get_message (exception) ); 


else 
g_print ("Script result: %s\n", str_value); 
g_free (str_value); 
} else { 
g_warning ("Error running javascript: unexpected return value"); 
} 
webkit_javascript_result_unref (js_result); 


static void 
web_view_get_link_url (WebKitWebView *web_view, 
const gchar *link_id) 


gchar *script = g_strdup_printf ("window.document.getElementBylId(’%s’) -href;", 


link_id); 


webkit_web_view_run_javascript (web_view, script, NULL, web_view_javascript_finished, NULL); 


g_free (script); 


Deprecated since: 2.40 
Use webkit_web_view_evaluate_javascript_finish () instead. 
Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 


Type: |WebKitJavascriptResult 


A WebKitJavascriptResult with the result of the last executed statement in script or NULL in 
case of error. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2ZWebViewrun_javascript_from_gresource 


deprecated: 2.40 


Declaration 


void 
webkit_web_view_run_javascript_from_gresource ( 
WebKitWebView* web_view, 
const gchar* resource, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously run the script from resource. 
Asynchronously run the script from resource in the context of the current page in web_view. 


When the operation is finished, callback will be called. You can then call 
webkit_web_view_run_javascript_from_gresource_finish() to get the result of 
the operation. 


Deprecated since: 2.40 
Use webkit_web_view_evaluate_javascript () instead. 
Parameters 
resource 
Type: const gchar* 
The location of the resource to load. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the script finished. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2WebViewrun_javascript_from_gresource_finish 


deprecated: 2.40 


Declaration 


WebKitJavascriptResult* 
webkit_web_view_run_javascript_from_gresource_finish ( 
WebKitWebView* web_view, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_web_view_run_javascript_from_gresource(). 


Check webkit_web_view_run_javascript_finish() fora usage example. 


Deprecated since: 2.40 


Use webkit_web_view_evaluate_javascript_finish () instead. 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 


Type: |WebKitJavascriptResult 


A WebKitJavascriptResult with the result of the last executed statement in script or NULL in 
case of error. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2WebViewrun_javascript_in_world 


deprecated: 2.40 since: 2.22 


Declaration 


void 
webkit_web_view_run_javascript_in_world ( 
WebKitWebView* web_view, 
const gchar* script, 
const gchar* world_name, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously run script in the script world. 


Asynchronously run script in the script world with name world_name of the current page context in 
web_view. If WebKitSettings:enable-javascript is FALSE, this method will do nothing. 


When the operation is finished, callback will be called. You can then call 
webkit_web_view_run_javascript_in_world_finish () to get the result of the operation. 


Available since: 2.22 
Deprecated since: 2.40 
Use webkit_web_view_evaluate_javascript () instead. 
Parameters 
script 
Type: const gchar* 
The script to run. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


world_name 
Type: const gchar* 
The name of aWebKitScriptWorld. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the script finished. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2WebViewrun_javascript_in_world_finish 


deprecated: 2.40 since: 2.22 


Declaration 


WebKitJavascriptResult* 
webkit_web_view_run_javascript_in_world_finish ( 
WebKitWebView* web_view, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_web_view_run_javascript_in_world(). 


Available since: 2.22 
Deprecated since: 2.40 


Use webkit_web_view_call_async_javascript_function_finish() instead. 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 


Type: |WebKitJavascriptResult 


A WebKitJavascriptResult with the result of the last executed statement in script or NULL in 
case of error. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2Web Viewsave 


Declaration 


void 

webkit_web_view_save ( 
WebKitWebView* web_view, 
WebKitSaveMode save_mode, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously save the current web page. 


Asynchronously save the current web page associated to the WebKit WebView into a self-contained 
format using the mode specified in save_mode. 


When the operation is finished, callback will be called. You can then call 
webkit_web_view_save_finish () to get the result of the operation. 


Parameters 
save_mode 


Type:|WebKitSaveMode 


The WebKit SaveMode specifying how the web page should be saved. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
call_async_javascript_function}call_async_javascript_function_finish}can_execute_editing_ command 


can_execute_editing command_finish}can_go_backjcan_go_forwardjcan_show_mime_type 


Generated by[gi-docgen|2023.3 
Method 


WebKit2Web Viewsave_finish 


Declaration 


GInputStream* 
webkit_web_view_save_finish ( 
WebKitWebView* web_view, 
GAsyncResult* result, 

GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_web_view_save(). 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error} 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 
Type: GInputStream 


A GInput Stream with the result of saving the current web page or NULL in case of error. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2Web Viewsave_to_file 


Declaration 


void 

webkit_web_view_save_to_file ( 
WebKitWebView* web_view, 
GFile* file, 
WebKitSaveMode save_mode, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Asynchronously save the current web page. 


Asynchronously save the current web page associated to the WebKit WebView into a self-contained 
format using the mode specified in save_mode and writing it to file. 


When the operation is finished, callback will be called. You can then call 
webkit_web_view_save_to_file_finish () to get the result of the operation. 


Parameters 
file 
Type: GFile 
The GF ile where the current web page should be saved to. 


The data is owned by the caller of the method. 


save_mode 


Type:|WebKitSaveMode 


The WebKit SaveMode specifying how the web page should be saved. 


cancellable 
Type: GCancellable 


A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


A GAsyncReadyCallback to call when the request is satisfied. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2WebViewsave_to_file_finish 


Declaration 


gboolean 
webkit_web_view_save_to_file_finish ( 
WebKitWebView* web_view, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_web_view_save_to_file(). 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 
The return location for[a recoverable error} 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 
Type: gboolean 


TRUE if the web page was successfully saved to a file or FALSE otherwise. 
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Method 


WebKit2WebViewsend_message_to_page 


since: 2.28 


Declaration 


void 

webkit_web_view_send_message_to_page ( 
WebKitWebView* web_view, 
WebKitUserMessage* message, 
GCancellable* cancellable, 
GAsyncReadyCallback callback, 
gpointer user_data 


Description 


Send message to the WebKitWebPage corresponding to web_view. 


If message is floating, it’s consumed. If you don’t expect any reply, or you simply want to ignore it, you 
can pass NULL as callback. When the operation is finished, callback will be called. You can then 
call webkit_web_view_send_message_to_page_finish () to get the message reply. 


Available since: 2.28 


Parameters 


message 


Type:\WebKitUserMessage 


A WebKitUserMessage. 


The data is owned by the caller of the method. 


cancellable 
Type: GCancellable 
A GCancellable or NULL to ignore. 


The argument can be NULL. 


The data is owned by the caller of the method. 


callback 
Type: GAsyncReadyCallback 


(nullable): A GAsyncReadyCallback to call when the request is satisfied or NULL. 


The argument can be NULL. 


user_data 
Type: gpointer 
The data to pass to callback function. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2WebViewsend_message_to_page_finish 


since: 2.28 


Declaration 


WebKitUserMessage* 
webkit_web_view_send_message_to_page_finish ( 
WebKitWebView* web_view, 
GAsyncResult* result, 
GError** error 


) 


Description 


Finish an asynchronous operation started with webkit_web_view_send_message_to_page(). 


Available since: 2.28 


Parameters 
result 
Type: GAsyncResult 


A GAsyncResult. 


The data is owned by the caller of the method. 


error 


Type: GError ** 


The return location for|a recoverable error 


The argument can be NULL. 
If the return location is not NULL, then you must initialize it toa NULL GError*. 
The argument will be left initialized to NULL by the method if there are no errors. 


In case of error, the argument will be set to a newly allocated GError; the caller will take 
ownership of the data, and be responsible for freeing it. 


Return value 


Type: |WebKitUserMessage 


A WebKitUserMessage with the reply or NULL in case of error. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2WebViewset_background_color 


since: 2.8 


Declaration 


void 


webkit_web_view_set_background_color ( 


) 


WebKitWebView* web_view, 
const GdkRGBA* rgba 


Description 


Sets the color that will be used to draw the web_view background. 


Sets the color that will be used to draw the web_view background before the actual contents are 
rendered. Note that if the web page loaded in web_view specifies a background color, it will take 
precedence over the rgba color. By default the web_view background color is opaque white. Note that 
the parent window must have a RGBA visual and GtkWidget : app-paintable property set to TRUE 
for backgrounds colors to work. 


static void browser_window_set_background_color (BrowserWindow *window, 


{ 


const GdkRGBA *rgba) 


WebKitWebView *web_view; 
GdkScreen *screen = gtk_window_get_screen (GTK_WINDOW (window) ); 
GdkVisual *rgba_visual = gdk_screen_get_rgba_visual (screen); 


if (!rgba_visual) 
return; 


gtk_widget_set_visual (GTK_WIDGET (window), rgba_visual); 
gtk_widget_set_app_paintable (GTK_WIDGET (window), TRUE); 


web_view = browser_window_get_web_view (window) ; 
webkit_web_view_set_background_color (web_view, rgba); 


Available since: 2.8 


Parameters 


rgba 


Type: GAkKRGBA 


A GdkRGBA. 


The data is owned by the caller of the method. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
call_async_javascript_function}call_async_javascript_function_finish}can_execute_editing_ command 


can_execute_editing command_finish}can_go_backjcan_go_forwardjcan_show_mime_type 


Generated by[gi-docgen|2023.3 
Method 


WebKit2WebViewset_camera_capture_state 


since: 2.34 


Declaration 


void 

webkit_web_view_set_camera_capture_state ( 
WebKitWebView* web_view, 
WebKitMediaCaptureState state 

) 


Description 


Set the camera capture state of aWebKitWebView. 


If WebKitSettings:enable-mediastream is FALSE, this method will have no visible effect. 
Once the state of the device has been set to WEBKIT_MEDIA CAPTURE_STATE NONE it cannot be 
changed anymore. The page can however request capture again using the mediaDevices API. 


Available since: 2.34 


Sets property |WebKit2.WebView:camera-capture-state 


Parameters 


state 


Type:\WebKitMediaCaptureState 


A WebKitMediaCaptureState. 
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Method 


WebKit2\WebViewset_cors_allowlist 


since: 2.34 


Declaration 


void 
webkit_web_view_set_cors_allowlist ( 
WebKitWebView* web_view, 
const gchar* const* allowlist 


) 


Description 


Sets the allowlist for CORS. 


Sets the allowlist for which|Cross-Origin Resource Sharing|checks are disabled in web_view. URI 


patterns must be of the form [protocol]://[host]/ [path], each component may contain the 
wildcard character (*) to represent zero or more other characters. All three components are required and 
must not be omitted from the URI patterns. 


Disabling CORS checks permits resources from other origins to load allowlisted resources. It does not 
permit the allowlisted resources to load resources from other origins. 


If this function is called multiple times, only the allowlist set by the most recent call will be effective. 


Available since: 2.34 


Parameters 
allowlist 
Type: An array of ut £8 
An allowlist of URI patterns, or NULL. 
The argument can be NULL. 
The array must be NULL-terminated. 


The data is owned by the caller of the method. 


Each element is a NUL terminated UTF-8 string. 
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Method 


WebKit2\WebViewset_custom_charset 


Declaration 


void 
webkit_web_view_set_custom_charset ( 
WebKitWebView* web_view, 
const gchar* charset 


) 


Description 


Sets the current custom character encoding override of web_view. 


The custom character encoding will override any text encoding detected via HTTP headers or META tags. 
Calling this method will stop any current load operation and reload the current page. Setting the custom 
character encoding to NULL removes the character encoding override. 


Parameters 
charset 
Type: const gchar* 
A character encoding name or NULL. 
The argument can be NULL. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2WebViewset_display_capture_state 


since: 2.34 


Declaration 


void 

webkit_web_view_set_display_capture_state ( 
WebKitWebView* web_view, 
WebKitMediaCaptureState state 

) 


Description 


Set the display capture state of aWebKitWebView. 


If WebKitSettings:enable-mediastream is FALSE, this method will have no visible effect. 
Once the state of the device has been set to WEBKIT_MEDIA CAPTURE_STATE_ NONE it cannot be 
changed anymore. The page can however request capture again using the mediaDevices API. 


Available since: 2.34 


Sets property |WebKit2.WebView:display-capture-state 


Parameters 


state 


Type:\WebKitMediaCaptureState 


A WebKitMediaCaptureState. 
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Method 


WebKit2Web Viewset_editable 


since: 2.8 


Declaration 


void 

webkit_web_view_set_editable ( 
WebKitWebView* web_view, 
gboolean editable 

) 


Description 


Sets whether the user is allowed to edit the HTML document. 


If editable is TRUE, web_view allows the user to edit the HTML document. If editable is 
FALSE, an element in web_view‘s document can only be edited if the CONTENTEDITABLE attribute 
has been set on the element or one of its parent elements. By default a WebKitWebView is not editable. 


Normally, a HTML document is not editable unless the elements within the document are editable. This 
function provides a way to make the contents of a WebKitWebView editable without altering the 
document or DOM structure. 


Available since: 2.8 


Sets property |WebKit2.WebView:editable 


Parameters 
editable 
Type: gboolean 


A #gboolean indicating the editable state. 
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Method 


WebKit2WebViewset_input_method_context 


since: 2.28 


Declaration 


void 

webkit_web_view_set_input_method_context ( 
WebKitWebView* web_view, 
WebKitInputMethodContext* context 

) 


Description 


Set the WebKit InputMethodContext to be used by web_view. 
Set the WebKit InputMethodContext to be used by web_view, or NULL to not use any input 
method. Note that the same WebKit InputMethodContext can’t be set on more than one 


WebKitWebView at the same time. 


Available since: 2.28 


Parameters 


context 


Type: |WebKit InputMethodContext 


The WebKit InputMethodContext to set, or NULL. 


The argument can be NULL. 


The data is owned by the caller of the method. 
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Method 


WebKit2Web Viewset_is_muted 


since: 2.30 


Declaration 


void 

webkit_web_view_set_is_muted ( 
WebKitWebView* web_view, 
gboolean muted 


) 


Description 


Sets the mute state of web_view. 


Available since: 2.30 


Sets property |WebKit2.WebView:is—muted 


Parameters 
muted 
Type: gboolean 


Mute flag. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
call_async_javascript_function}call_async_javascript_function_finish}can_execute_editing_ command 


can_execute_editing command_finish}can_go_backjcan_go_forwardjcan_show_mime_type 


Generated by[gi-docgen|2023.3 
Method 


WebKit{WebViewset_microphone_capture_state 


since: 2.34 


Declaration 


void 

webkit_web_view_set_microphone_capture_state ( 
WebKitWebView* web_view, 
WebKitMediaCaptureState state 

) 


Description 


Set the microphone capture state of a WebKitWebView. 


If WebKitSettings:enable-mediastream is FALSE, this method will have no visible effect. 
Once the state of the device has been set to WEBKIT_MEDIA CAPTURE_STATE NONE it cannot be 
changed anymore. The page can however request capture again using the mediaDevices API. 


Available since: 2.34 


Sets property |WebKit2.WebView:microphone-capture-state 


Parameters 


state 


Type:\WebKitMediaCaptureState 


A WebKitMediaCaptureState. 
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Method 


WebKit2Web Viewset_settings 


Declaration 


void 

webkit_web_view_set_settings ( 
WebKitWebView* web_view, 
WebKitSettings* settings 

) 


Description 


Sets the WebKitSettings to be applied to web_view. 
The existing WebKit Settings of web_view will be replaced by sett ings. New settings are 


applied immediately on web_view. The same WebKit Settings object can be shared by multiple 
WebKitWebViews. 


Sets property |WebKit2.WebView:settings 


Parameters 


settings 


Type:\WebKitSettings 


A WebKitSettings. 


The data is owned by the caller of the method. 
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Method 


WebKit2Web Viewset_zoom_level 


Declaration 


void 

webkit_web_view_set_zoom_level ( 
WebKitWebView* web_view, 
gdouble zoom_level 


) 


Description 


Set the zoom level of web_view. 


Set the zoom level of web_view, i.e. the factor by which the view contents are scaled with respect to 
their original size. 


Sets property |WebKit2.WebView: zoom-level 


Parameters 
zoom_level 
Type: gdouble 


The zoom level. 
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Method 


WebKit2Web Viewstop_loading 


Declaration 


void 

webkit_web_view_stop_loading ( 
WebKitWebView* web_view 

) 


Description 


Stops any ongoing loading operation in web_view. 


This method does nothing if no content is being loaded. If there is a loading operation in progress, it will 
be cancelled and WebKitWebView: : load-failed signal will be emitted with 
WEBKIT_NETWORK_ERROR_CANCELLED error. 
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Method 


WebKit2WebViewterminate_web_process 


since: 2.34 


Declaration 


void 

webkit_web_view_terminate_web_process ( 
WebKitWebView* web_view 

) 


Description 


Terminates the web process associated to web_view. 


When the web process gets terminated using this method, the 
WebKitWebView: :web-process-terminated signal is emitted with 
WEBKIT_WEB PROCESS _TERMINATED_BY_APT as the reason for termination. 


Available since: 2.34 
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Method 


WebKit2Web Viewtry_close 


since: 2.12 


Declaration 


void 

webkit_web_view_try_close ( 
WebKitWebView* web_view 

) 


Description 


Tries to close the web_view. 


This will fire the onbeforeunload event to ask the user for confirmation to close the page. If there isn’t an 
onbeforeunload event handler or the user confirms to close the page, the WebKitWebView::close 
signal is emitted, otherwise nothing happens. 


Available since: 2.12 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 


Generated by[gi-docgen]2023.3 


Property 

WebKit2WebView:automation-presentation-type 

since: 2.28 

Declaration 

property automation-presentation-type: WebKit2.AutomationBrowsingContextPresentation [ read, write, construct-only ] 


Description 


The WebKitAutomationBrowsingContextPresentation of WebKitWebView. This should 
only be used when creating a new WebKitWebView as a response to 
WebKitAutomationSession: :create-web-—view signal request. If the new WebView was 
added to a new tab of current browsing context window 
WEBKIT_AUTOMATION_BROWSING_CONTEXT_PRESENTATION_TAB should be used. 


Type: WebKitAutomationBrowsingContextPresentation 
Available since: = 2.28 


eas WEBKIT_AUTOMATION_BROWSING_CONTEXT_PRESENTATION_WINDOW 


value 

Getter webkit_web_view_get_automation_presentation_type() 

method 4 = a 
Flags 

Readable yes 

Writable yes 

Construct no 


Construct only yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 


Generated by[gi-docgen]2023.3 


Property 

WebKit2\Web View:camera-capture-state 

since: 2.34 

Declaration 

property camera-capture-state: WebKit2.MediaCaptureState [ read, write ] 


Description 


Capture state of the camera device. Whenever the user grants a media-request sent by the web page, 
requesting video capture capabilities (navigator.mediaDevices.getUserMedia ({video: 
true}) ) this property will be set to WEBKIT_MEDIA_CAPTURE_STATE_ACTIVE. 


The application can monitor this property and provide a visual indicator allowing to optionally deactivate 
or mute the capture device by setting this property respectively to 
WEBKIT_ MEDIA CAPTURE_STATE_NONE or WEBKIT_ MEDIA CAPTURE_STATE_MUTED. 


If the capture state of the device is set to WEBKIT_MEDIA_CAPTURE_STATE_NONE the web-page can 
still re-request the permission to the user. Permission desision caching is left to the application. 


Type: 
Available since: 2.34 


Default value WEBKIT_MEDIA_CAPTURE_STATE_NONE 


Getter method |webkit_web_view_get_camera_capture_state() 


Setter method webkit_web_view_set_camera_capture_state() 


Flags 
Readable yes 
Writable yes 
Construct no 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 


Generated by[gi-docgen]2023.3 


Property 


WebKit2\Web View:default-content-security-policy 


since: 2.38 


Declaration 


property default-content-security-policy: utf8 [ read, write, construct-only ] 


Description 


The default Content-Security-Policy used by the webview as if it were set by an HTTP header. 


This applies to all content loaded including through navigation or via the various 
webkit_web_view_load_* APIs. However do note that many WebKit APIs bypass 
Content-Security-Policy in general such as WebKitUserContentManager 
and webkit_web_view_run_javascript(). 


Policies are additive so if a website sets its own policy it still applies on top of the policy set here. 


Type: gchar* 
Available since: 2.38 


Default value 


Getter method 


Flags 


Readable 
Writable 
Construct 


Construct only 


NULL 


webkit_web_view_get_det 


yes 
yes 
no 


yes 


fault_content_security_policy () 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 


Generated by[gi-docgen]2023.3 


Property 


WebKit2\WebView:rdisplay-capture-state 


since: 2.34 


Declaration 


property display-capture-state: WebKit2.MediaCaptureState [ read, write ] 


Description 


Capture state of the display device. Whenever the user grants a media-request sent by the web page, 
requesting screencasting capabilities (navigator.mediaDevices.getDisplayMedia() this 
property will be set toWEBKIT_MEDIA_CAPTURE_STATE_ACTIVE*. 


The application can monitor this property and provide a visual indicator allowing to optionally deactivate 
or mute the capture device by setting this property respectively to 
WEBKIT_ MEDIA CAPTURE_STATE_NONE or WEBKIT_ MEDIA CAPTURE_STATE_MUTED. 


If the capture state of the device is set to WEBKIT_MEDIA_CAPTURE_STATE_NONE the web-page can 
still re-request the permission to the user. Permission desision caching is left to the application. 


Type: 
Available since: 2.34 


Default value WEBKIT_MEDIA_CAPTURE_STATE_NONE 


Getter method |webkit_web_view_get_display_capture_state() 
Setter method webkit_web_view_set_display_capture_state() 


Flags 
Readable yes 
Writable yes 
Construct no 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 


Generated by[gi-docgen]2023.3 


Property 
WebKit2WebView:editable 
since: 2.8 

Declaration 

property editable: gboolean [ read, write ] 


Description 


Whether the pages loaded inside WebKitWebView are editable. For more information 
see webkit_web_view_set_editable(). 


Type: gboolean 


Available since: 2.8 


Default value FALSE 


Setter method |webkit_web_view_set_editable() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 


WebKit2\Web View:estimated-load-progress 


unstable since: 4.1 


Declaration 


property estimated-load-progress: double [ read ] 


Description 


An estimate of the percent completion for the current loading operation. This value will range from 0.0 to 
1.0 and, once a load completes, will remain at 1.0 until a new load starts, at which point it will be reset to 
0.0. The value is an estimate based on the total number of bytes expected to be received for a document, 
including all its possible subresources and child documents. 


Type: gdouble 


Available since: 4.1 


Default value 0.000000 
Getter method |webkit_web_view_get_estimated_load_progress () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 


WebKit2Web View;favicon 


unstable since: 4.1 


Declaration 


property favicon: gpointer [ read ] 


Description 


The favicon currently associated to the WebKitWebView. See 
webkit_web_view_get_favicon() for more details. 


Type: gpointer 


Available since: 4.1 


Getter method |webkit_web_view_get_favicon() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 


WebKit2Web Viewris-controlled-by-automation 


since: 2.18 


Declaration 


property is-controlled-by-automation: gboolean [ read, write, construct-only ] 


Description 


Whether the WebKitWebView is controlled by automation. This should only be used when creating a 
new WebKitWebView as a response to WebKitAutomationSession: :create-web-view 
signal request. 


Type: gboolean 
Available since: 2.18 


Default value FALSE 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 

WebKit2iWeb Viewris-ephemeral 
since: 2.16 

Declaration 


property is-ephemeral: gboolean [ read, write, construct-only ] 


Description 


Whether the WebKitWebView is ephemeral. An ephemeral web view never writes website data to the 
client storage, no matter what WebKitWebsiteDataManager its context is using. This is normally 
used to implement private browsing mode. This is a G_PARAM_CONSTRUCT_ONLY property, so you 
have to create an ephemeral WebKitWebView and it can’t be changed. The ephemeral 
WebKitWebsiteDataManager created for the WebKitWebView will inherit the network settings 
from the WebKitWebContext‘s WebKitWebsiteDataManager. To use different settings you can 
get the WebKitWebsiteDataManager with 
webkit_web_view_get_website_data_manager () and set the new ones. Note that all 
WebKitWebViews created with an ephemeral WebKitWebContext will be ephemeral automatically. 
See also webkit_web_context_new_ephemeral(). 


Type: gboolean 
Available since: 2.16 


Default value FALSE 


Flags 
Readable yes 
Writable yes 
Construct no 


Construct only yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 


WebKit2Web Viewsis-loading 


unstable since: 4.1 


Declaration 


property is-loading: gboolean [ read ] 


Description 


Whether the WebKitWebView is currently loading a page. This property becomes TRUE as soon as a 
new load operation is requested and before the WebKitWebView: : load-changed signal is emitted 
with WEBKIT_LOAD_STARTED and at that point the active URI is the requested one. When the load 
operation finishes the property is set to FALSE before WebKitWebView: : load-changed is emitted 
with WEBKIT_LOAD_FINISHED. 

Type: gboolean 


Available since: 4.1 


Default value FALSE 


Getter method |webkit_web_view_is_loading() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 
WebKit2WebViewtis-muted 
since: 2.30 

Declaration 

property is-muted: gboolean [ read, write ] 


Description 


Whether the WebKitWebView audio is muted. When TRUE, audio is silenced. It may still be playing, i.e. 
WebKitWebView:is-—playing-audio may be TRUE. 


Type: gboolean 
Available since: 2.30 


Default value FALSE 


Getter method |webkit_web_view_get_is_muted() 


Setter method webkit_web_view_set_is_muted() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 


Generated by[gi-docgen]2023.3 


Property 
WebKit2WebViewris-playing-audio 
since: 2.8 

Declaration 

property is-playing-audio: gboolean [ read ] 


Description 


Whether the WebKitWebView is currently playing audio from a page. This property becomes TRUE as 
soon as web content starts playing any kind of audio. When a page is no longer playing any kind of sound, 
the property is set back to FALSE. 


Type: gboolean 


Available since: 2.8 


Default value FALSE 


Getter method |webkit_web_view_is_playing_audio() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 

WebKit2\Web Viewris-web-process-responsive 
since: 2.34 

Declaration 

property is-web-process-responsive: gboolean [ read ] 


Description 


Whether the web process currently associated to the WebKitWebView is responsive. 


Type: gboolean 
Available since: 2.34 


Default value TRUE 


Getter method |webkit_web_view_get_is_web_process_responsive () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 
WebKit2WebView:microphone-capture-state 
since: 2.34 

Declaration 


property microphone-capture-state: WebKit2.MediaCaptureState [ read, write ] 


Description 


Capture state of the microphone device. Whenever the user grants a media-request sent by the web page, 
requesting audio capture capabilities (navigator.mediaDevices.getUserMedia({audio: 
true}) ) this property will be set to WEBKIT_MEDIA_CAPTURE_STATE_ACTIVE. 


The application can monitor this property and provide a visual indicator allowing to optionally deactivate 
or mute the capture device by setting this property respectively to 
WEBKIT_ MEDIA CAPTURE_STATE_NONE or WEBKIT_ MEDIA CAPTURE_STATE_MUTED. 


If the capture state of the device is set to WEBKIT_MEDIA_CAPTURE_STATE_NONE the web-page can 
still re-request the permission to the user. Permission desision caching is left to the application. 


Type: 
Available since: 2.34 


Default value WEBKIT_MEDIA_CAPTURE_STATE_NONE 


Getter method |webkit_web_view_get_microphone_capture_state() 


Setter method webkit_web_view_set_microphone_capture_state() 


Flags 
Readable yes 
Writable yes 
Construct no 


Construct only no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 
WebKit2WebView;page-id 
since: 2.28 

Declaration 


property page-id: guint64 [ read ] 


Description 


The identifier of the WebKitWebPage corresponding to the WebKitWebView. 
Type: guint 64 


Available since: 2.28 


Default value 0 


Getter method |webkit_web_view_get_page_id() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 
WebKit2WebView:related-view 
since: 2.4 

Declaration 


property related-view: WebKit2.WebView [ write, construct-only ] 


Description 


The related WebKit WebView used when creating the view to share the same web process and network 
session. This property is not readable because the related web view is only valid during the 
object construction. 


Type: 


Available since: 2.4 


Flags 


Readable 
Writable 
Construct 


Construct only 


no 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 
WebKit2WebViewssettings 
since: 2.6 

Declaration 


property settings: WebKit2.Settings [ write, construct ] 


Description 


The WebKitSettings of the view. 


Type: WebKitSettings 


Available since: 2.6 


Setter method |webkit_web_view_set_settings () 


Flags 


Readable 
Writable 
Construct 


Construct only 


no 
yes 
yes 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 


WebKit2Web View;title 


unstable since: 4.1 


Declaration 


property title: utf8 [ read ] 


Description 


The main frame document title of this WebKit WebView. If the title has not been received yet, it will be 
NULL. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_web_view_get_title() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 


WebKit2Web Viewpuri 


unstable since: 4.1 


Declaration 


property uri: utf8 [ read ] 


Description 


The current active URI of the WebKitWebView. See webkit_web_view_get_uri () for 
more details. 


Type: gchar* 


Available since: 4.1 


Default value NULL 


Getter method |webkit_web_view_get_uri () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
no 
no 


no 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 

WebKit2\Web View;user-content-manager 
since: 2.6 

Declaration 


property user-content-manager: WebKit2.UserContentManager [ read, write, construct-only ] 


Description 


The WebKitUserContentManager of the view. 


Type: WebKitUserContentManager 


Available since: 2.6 


Getter method |webkit_web_view_get_user_content_manager () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 


WebKit2Web View;web-context 


unstable since: 4.1 


Declaration 


property web-context: WebKit2.WebContext [ read, write, construct-only ] 


Description 


The WebKitWebContext of the view. 


Type: WebKitWebContext 


Available since: 4.1 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 

WebKit2Web View: web-extension-mode 

since: 2.38 

Declaration 

property web-extension-mode: WebKit2.WebExtensionMode [ read, write, construct-only ] 


Description 


This configures web_view to treat the content as a WebExtension. 
Note that this refers to the web standard|WebExtensions|and not WebKitWebExtensions. 


In practice this limits the Content-Security-Policies that are allowed to be set. Some details can be found 


in{Chrome’s documentation 


Type: 
Available since: 2.38 


Default value WEBKIT_WEB_EXTENSION_MODE_NONE 


Getter method |webkit_web_view_get_web_extension_mode() 


Flags 
Readable yes 
Writable yes 
Construct no 


Construct only yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 


Generated by[gi-docgen]2023.3 


Property 

WebKit2\Web View: website-policies 
since: 2.30 

Declaration 


property website-policies: WebKit2.WebsitePolicies [ read, write, construct-only ] 


Description 


The WebKitWebsitePolicies for the view. 


Type: WebKitWebsitePolicies 


Available since: 2.30 


Getter method |webkit_web_view_get_website_policies () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Properties 


automation-presentation-type default-content-security-policy|display-capture-state 
editablejestimated-load-progress is-controlled-by-automation 


iS-playing-audiofis-web-process-responsive|microphone-capture-state|page-id|related-viewJsettings|title 
user-content-manager|web-context|web-extension-mode|website-policies|zoom-level 
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Property 


WebKit2Web View;zoom-level 


unstable since: 4.1 


Declaration 


property zoom-level: double [ read, write ] 


Description 


The zoom level of the WebKitWebView content. See webkit_web_view_set_zoom_level () 
for more details. 


Type: gdouble 


Available since: 4.1 


Default value 1.000000 
Getter method |webkit_web_view_get_zoom_level () 


Setter method webkit_web_view_set_zoom_level () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


no 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
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Signal 


WebKit2|WebView::authenticate 


since: 2.2 


Declaration 


gboolean 

authenticate ( 
WebKitWebView* self, 
WebKitAuthenticationRequest* request, 
gpointer user_data 

) 


Description 


This signal is emitted when the user is challenged with HTTP authentication. To let the application access 
or supply the credentials as well as to allow the client application to either cancel the request or perform 
the authentication, the signal will pass an instance of the WebKitAuthenticationRequest in the 
request argument. To handle this signal asynchronously you should keep a ref of the request and return 
TRUE. To disable HTTP authentication entirely, connect to this signal and simply return TRUE. 


The default signal handler will run a default authentication dialog asynchronously for the user to 
interact with. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.2 


Parameters 


request 


Type: |(WebKitAuthenticationRequest 


A WebKitAuthenticationRequest. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 
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Signal 


WebKit2Web View;:close 


unstable since: 4.1 


Declaration 


void 

close ( 
WebKitWebView* self, 
gpointer user_data 


) 


Description 


Emitted when closing a WebKit WebView is requested. This occurs when a call is made from 
JavaScript’s window.close function or after trying to close the web_view with 
webkit_web_view_try_close(). It is the owner’s responsibility to handle this signal to hide or destroy the 
WebKitWebView, if necessary. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 
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Signal 


WebKit2Web View;:context-menu 


unstable since: 4.1 


Declaration 


gboolean 

context_menu ( 
WebKitWebView* self, 
WebKitContextMenu* context_menu, 
GdkEvent* event, 
WebKitHitTestResult* hit_test_result, 
gpointer user_data 


Description 


Emitted when a context menu is about to be displayed to give the application a chance to customize the 
proposed menu, prevent the menu from being displayed, or build its own context menu. To customize the 
proposed menu you can use webkit_context_menu_prepend(), webkit_context_menu_append () 
or webkit_context_menu_insert () to add new WebKitContextMenulItems to 
context_menu, webkit_context_menu_move_item() to reorder existing items, or 
webkit_context_menu_remove () to remove an existing item. The signal handler should return 
FALSE, and the menu represented by context_menu will be shown. To prevent the menu from being 


displayed you can just connect to this signal and return TRUE so that the proposed menu will not be 
shown. To build your own menu, you can remove all items from the proposed menu with 
webkit_context_menu_remove_all(), add your own items and return FALSE so that the menu will be 
shown. You can also ignore the proposed WebKitContextMenu, build your own Gt kMenu and return 
TRUE to prevent the proposed menu from being shown. If you just want the default menu to be shown 
always, simply don’t connect to this signal because showing the proposed context menu is the default 
behaviour. 


The event parameter is now deprecated. Use webkit_context_menu_get_event () to get the 
GdkEvent that triggered the context menu. 


If the signal handler returns FALSE the context menu represented by context_menu will be shown, if it 
return TRUE the context menu will not be shown. 


The proposed WebKitContextMenu passed in context_menu argument is only valid during the 
signal emission. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


context_menu 


Type:|WebKitContextMenu 


The proposed WebKitContextMenu. 


The data is owned by the caller of the function. 


event 
Type: GdkEvent 


The GdkEvent that triggered the context menu. Deprecated 2.40. 


The data is owned by the caller of the function. 


hit_test_result 


Type:\(WebKitHitTestResult 


A WebKitHitTestResult. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 
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Signal 


WebKit2\Web View: :context-menu-dismissed 


unstable since: 4.1 


Declaration 


void 

context_menu_dismissed ( 
WebKitWebView* self, 
gpointer user_data 


) 


Description 


Emitted after WebKitWebView: :context-—menu signal, if the context menu is shown, to notify that 
the context menu is dismissed. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 
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Signal 


WebKit2Web View;:create 


unstable since: 4.1 


Declaration 


GtkWidget* 

create ( 
WebKitWebView* self, 
WebKitNavigationAction* navigation_action, 
gpointer user_data 

) 


Description 


Emitted when the creation of a new WebKit WebView is requested. If this signal is handled the signal 
handler should return the newly created WebKitWebView. 


The WebKitNavigationAction parameter contains information about the navigation action that 
triggered this signal. 


The new WebKitWebView must be related to web_view, see WebKitWebView: related-view 
for more details. 


The new WebKitWebView should not be displayed to the user until the 
WebKitWebView: : ready—to-show signal is emitted. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


navigation_action 


Type:|WebKitNavigationAction 


A WebKitNavigationAction. 


The data is owned by the caller of the function. 


Return value 
Type: GtkWidget 


A newly allocated WebKitWebView widget or NULL to propagate the event further. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 
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Signal 


WebKit2Web View;:decide-policy 


unstable since: 4.1 


Declaration 


gboolean 

decide_policy ( 
WebKitWebView* self, 
WebKit2PolicyDecision* decision, 
WebKitPolicyDecisionType decision_type, 
gpointer user_data 


) 


Description 


This signal is emitted when WebKit is requesting the client to decide a policy decision, such as whether to 
navigate to a page, open a new window or whether or not to download a resource. The 
WebKitNavigationPolicyDecision passed in the decision argument is a generic type, but 
should be casted to a more specific type when making the decision. For example: 


static gboolean 
decide_policy_cb (WebKitWebView *web_view, 
icyDecision *decision, 
icyDecisionType type) 


WebKitPol 
WebKitPol 


switch (type) { 


case WEB 
WebK 


brea 
} 
case WEB 
WebK 


brea 


} 
case WEB 


WebKitResponsePolicyDecision *response 


KIT_POLICY_DEC 
itNavigationPol 


Ki; 


KIT_POLICY_DEC 
itNavigationPol 


K7 


KIT_POLICY_DEC 


SION_TYPE_NAVIGATION_ACTION: { 
icyDecision *navigation_decision = WEBKIT_NAVIGATION_POLICY_DECISION (decision) ; 
// Make a policy decision here 


SION_TYPE_NEW_WINDOW_ACTION: { 


icyDecision *navigation_decision = WEBKIT_NAVIGATION_POLICY_DECISION (decision) ; 
// Make a policy decision here 


SION_TYPE_RESPONSE: 


// Make a policy decision here 


brea 
default: 


K7 


= WEBKIT_RESPONSE_POLICY_DECISION (decision); 


// Making no decision results in webkit_policy_decision_use() 
return FALSE; 


} 


return TRUE; 


It is possible to make policy decision asynchronously, by simply calling g_object_ref () on the 
decision argument and returning TRUE to block the default signal handler. If the last reference is 
removed on a WebKitPolicyDecision and no decision has been made explicitly, 
webkit_policy_decision_use() will be the default policy decision. The default signal handler 
will simply call webkit_policy_decision_use(). Only the first policy decision chosen for a given 
WebKitPolicyDecision will have any affect. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available 


since: 4.1 


Parameters 


decision 


Type:|WebKitPolicyDecision 


The WebKitPolicyDecision. 


The data is owned by the caller of the function. 


decision_type 


Type:|WebKitPolicyDecisionType 


A WebKitPolicyDecisionType denoting the type of decision. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 
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Signal 


WebKit2\Web View;:enter-fullscreen 


unstable since: 4.1 


Declaration 


gboolean 

enter_fullscreen ( 
WebKitWebView* self, 
gpointer user_data 


) 


Description 


Emitted when JavaScript code calls element.webkitRequestFullScreen. If the signal is not handled the 
WebKitWebView will proceed to full screen its top level window. This signal can be used by client code 
to request permission to the user prior doing the full screen transition and eventually prepare the top-level 
window (e.g. hide some widgets that would otherwise be part of the full screen window). 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to continue emission of the event. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 
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Signal 


WebKit2\Web View: :insecure-content-detected 


unstable since: 4.1 


Declaration 


void 

insecure_content_detected ( 
WebKitWebView* self, 
WebKitInsecureContentEvent event, 
gpointer user_data 

) 


Description 


This signal is emitted when insecure content has been detected in a page loaded through a secure 
connection. This typically means that a external resource from an unstrusted source has been run or 
displayed, resulting in a mix of HTTPS and non-HTTPS content. 


You can check the event parameter to know exactly which kind of event has been detected (see 
WebKit InsecureContentEvent). 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


event 


Type:\(WebKitInsecureContentEvent 


The WebKit InsecureContentEvent. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
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web-process-terminated 
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Signal 


WebKit2iWeb View::leave-fullscreen 


unstable since: 4.1 


Declaration 


gboolean 

leave_fullscreen ( 
WebKitWebView* self, 
gpointer user_data 


) 


Description 


Emitted when the WebKit WebView is about to restore its top level window out of its full screen state. 
This signal can be used by client code to restore widgets hidden during the 
WebKitWebView: :enter—fullscreen stage for instance. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to continue emission of the event. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 
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Signal 


WebKit2Web View;:load-changed 


unstable since: 4.1 


Declaration 


void 

load_changed ( 
WebKitWebView* self, 
WebKitLoadEvent load_event, 
gpointer user_data 

) 


Description 


Emitted when a load operation in web_view changes. The signal is always emitted with 


WEBKIT_LOAD_STARTED when a new load request is made and WEBKIT_LOAD_F INISHED when the 


load finishes successfully or due to an error. When the ongoing load operation fails 


WebKitWebView: : load-failed signal is emitted before WebKitWebView: : load-changed is 


emitted with WEBKIT_LOAD_FINISHED. If a redirection is received from the server, this signal is 


emitted with WEBKIT_LOAD_REDIRECTED after the initial emission with WEBKIT_LOAD_STARTED 


and before WEBKIT_LOAD_COMMITTED. When the page content starts arriving the signal is emitted 
with WEBKIT_LOAD_COMMITTED event. 


You can handle this signal and use a switch to track any ongoing load operation. 


static void web_view_load_changed (WebKitWebView *web_view, 
WebKitLoadEvent load_event, 
gpointer user_data) 


switch (load_event) { 

case WEBKIT_LOAD_STARTED: 
// New load, we have now a provisional URI 
provisional_uri = webkit_web_view_get_uri (web_view) ; 
// Here we could start a spinner or update the 
// location bar with the provisional URI 


break; 

case WEBKIT_LOAD REDIRECTED: 
redirected_uri = webkit_web_view_get_uri (web_view); 
break; 

case WEBKIT_LOAD_COMMITTED: 


// The load is being performed. Current URI is 
// the final one and it won’t change unless a new 
// load is requested or a navigation within the 
// same page is performed 
uri = webkit_web_view_get_uri (web_view) ; 
break; 

case WEBKIT_LOAD_FINISHED: 
// Load finished, we can now stop the spinner 
break; 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


load_event 


Type: |WebKitLoadEvent 


The WebKit LoadEvent. 
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web-process-terminated 
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Signal 


WebKit2Web Views:load-failed 


unstable since: 4.1 


Declaration 


gboolean 

load_failed ( 
WebKitWebView* self, 
WebKitLoadEvent load_event, 
gchar* failing_uri, 
GError* error, 
gpointer user_data 


Description 


Emitted when an error occurs during a load operation. If the error happened when starting to load data for 
a page load_event will be WEBKIT_LOAD_STARTED. If it happened while loading a committed data 
source load_event will be WEBKIT_LOAD_COMMITTED. Since a load error causes the load operation 
to finish, the signal WebKitWebView::load-changed will always be emitted with 
WEBKIT_LOAD_FINISHED event right after this one. 


By default, if the signal is not handled, a stock error page will be displayed. You need to handle the signal 
if you want to provide your own error page. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 
load_event 


Type: |WebKit LoadEvent 


The WebKit LoadEvent of the load operation. 


failing_uri 
Type: gchar* 
The URI that failed to load. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


error 
Type: GError 


The GError that was triggered. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 
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Signal 


WebKit2\Web View: :load-failed-with-tls-errors 


since: 2.6 


Declaration 


gboolean 
load_failed_with_tls_errors ( 
WebKitWebView* self, 
gchar* failing_uri, 
GTlsCertificate* certificate, 
GTlsCertificateFlags errors, 
gpointer user_data 


Description 


Emitted when a TLS error occurs during a load operation. To allow an exception for this certificate 
and the host of failing_uri use webkit_web_context_allow_tls_certificate_for_host(). 


To handle this signal asynchronously you should call g_object_ref() on certificate and return 
TRUE. 


If FALSE is returned, WebKitWebView: : load-failed will be emitted. The load will finish 
regardless of the returned value. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.6 


Parameters 
failing_uri 
Type: gchar* 
The URI that failed to load. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


certificate 
Type: GTlsCertificate 


AGTlsCertificate. 


The data is owned by the caller of the function. 


errors 
Type: GTlsCertificateFlags 


A GTlsCertificateFlags with the verification status of certificate. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
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web-process-terminated 
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Signal 


WebKit2\Web View: :mouse-target-changed 


unstable since: 4.1 


Declaration 


void 

mouse_target_changed ( 
WebKitWebView* self, 
WebKitHitTestResult* hit_test_result, 
guint modifiers, 
gpointer user_data 


) 


Description 


This signal is emitted when the mouse cursor moves over an element such as a link, image or a media 
element. To determine what type of element the mouse cursor is over, a Hit Test is performed on the 
current mouse coordinates and the result is passed in the hit_test_result argument. The 
modifiers argument is a bitmask of GdkModifierType flags indicating the state of modifier keys. 
The signal is emitted again when the mouse is moved out of the current element with a new 
hit_test_result. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


hit_test_result 


Type:\(WebKitHitTestResult 


A WebKitHitTestResult. 


The data is owned by the caller of the function. 


modifiers 
Type: guint 


A bitmask of GdkModifierType. 
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Signal 


WebKit2\Web View: :permission-request 


unstable since: 4.1 


Declaration 


gboolean 

permission_request ( 
WebKitWebView* self, 
WebKit2PermissionRequest* request, 
gpointer user_data 

) 


Description 


This signal is emitted when WebKit is requesting the client to decide about a permission request, such as 
allowing the browser to switch to fullscreen mode, sharing its location or similar operations. 


A possible way to use this signal could be through a dialog allowing the user decide what to do with 
the request: 


static gboolean permission_request_cb (WebKitWebView *web_view, 
WebKitPermissionRequest *request, 
GtkWindow *parent_window) 


GtkWidget *dialog = gtk_message_dialog_new (parent_window, 
GTK_DIALOG_MODAL, 
GTK_MESSAGE_QUESTION, 
GTK_BUTTONS_YES_NO, 
"Allow Permission Request?"); 


gtk_widget_show (dialog); 
gint result = gtk_dialog_run (GTK_DIALOG (dialog) ); 


switch (result) { 

case GTK_RESPONSE_YES: 
webkit_permission_request_allow (request) ; 
break; 

default: 
webkit_permission_request_deny (request) ; 
break; 


} 
gtk_widget_destroy (dialog); 


return TRUE; 


It is possible to handle permission requests asynchronously, by simply calling g_object_ref () on the 
request argument and returning TRUE to block the default signal handler. If the last reference is 
removed on a WebKitPermissionRequest and the request has not been handled, 
webkit_permission_request_deny () will be the default action. 


If the signal is not handled, the request will be completed automatically by the specific 


WebKitPermissionRequest that could allow or deny it. Check the documentation of classes 
implementing WebKitPermissionRequest interface to know their default action. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


request 


Type:\(WebKitPermissionRequest 


The WebKitPermissionRequest. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 
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Signal 


WebKit2Web View;:print 


unstable since: 4.1 


Declaration 


gboolean 

print ( 
WebKitWebView* self, 
WebKitPrintOperation* print_operation, 
gpointer user_data 

) 


Description 


Emitted when printing is requested on web_view, usually by a JavaScript call, before the print dialog is 
shown. This signal can be used to set the initial print settings and page setup of print_operation to 
be used as default values in the print dialog. You can call 
webkit_print_operation_set_print_settings() and 
webkit_print_operation_set_page_setup () and then return FALSE to propagate the event 
so that the print dialog is shown. 


You can connect to this signal and return TRUE to cancel the print operation or implement your own 
print dialog. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


print_operation 


Type:\WebKitPrintOperation 


The WebKitPrintOperation that will handle the print request. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 
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Signal 


WebKit2\Web View: :query-permission-state 


since: 2.40 


Declaration 


gboolean 

query_permission_state ( 
WebKitWebView* self, 
WebKitPermissionStateQuery* query, 
gpointer user_data 

) 


Description 


This signal allows the User-Agent to respond to permission requests for powerful features, as specified by 


the|Permissions W3C Specification} You can reply to the query 


using webkit_permission_state_query_finish(). 


You can handle the query asynchronously by calling webkit_permission_state_query_ref () 
on query and returning TRUE. If the last reference of query is removed and the query has not been 
handled, the query result will be set to WEBKIT_QUERY_PERMISSION_PROMPT. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.40 


Parameters 


query 


Type:\(WebKitPermissionStateQuery 


The WebKitPermissionStateQuery. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE if the message was handled, or FALSE otherwise. 
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Signal 


WebKit2Web View;:ready-to-show 


unstable since: 4.1 


Declaration 


void 

ready_to_show ( 
WebKitWebView* self, 
gpointer user_data 


) 


Description 


Emitted after WebKitWebView: : create on the newly created WebKitWebView when it should be 
displayed to the user. When this signal is emitted all the information about how the window should look, 


including size, position, whether the location, status and scrollbars should be displayed, is already set on 
the WebKitWindowProperties of web_view. See 
also webkit_web_view_get_window_properties(). 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 
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Signal 


WebKit2\Web View: :resource-load-started 


unstable since: 4.1 


Declaration 


void 

resource_load_started ( 
WebKitWebView* self, 
WebKitWebResource* resource, 
WebKitURIRequest* request, 
gpointer user_data 


) 


Description 


Emitted when a new resoutce is going to be loaded. The request parameter contains the 


WebKitURIRequest that will be sent to the server. You can monitor the load operation by connecting 


to the different signals of resource. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


resource 


Type:|WebKitWebResource 


A WebKitWebResource. 


The data is owned by the caller of the function. 


request 


Type: |WebKitURIRequest 


A WebKitURIRequest. 


The data is owned by the caller of the function. 
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Signal 


WebKit2Web View;:run-as-modal 


unstable since: 4.1 


Declaration 


void 

run_as_modal ( 
WebKitWebView* self, 
gpointer user_data 


) 


Description 


Emitted after WebKitWebView: : ready—to-show on the newly created WebKitWebView when 
JavaScript code calls window.showModalDialog. The purpose of this signal is to allow the client 
application to prepare the new view to behave as modal. Once the signal is emitted a new main loop will 
be run to block user interaction in the parent WebKitWebView until the new dialog is closed. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 
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Signal 


WebKit2Web View: :run-color-chooser 


since: 2.8 


Declaration 


gboolean 

run_color_chooser ( 
WebKitWebView* self, 
WebKitColorChooserRequest* request, 
gpointer user_data 

) 


Description 


This signal is emitted when the user interacts with a HTML element, requesting from WebKit to show a 
dialog to select a color. To let the application know the details of the color chooser, as well as to allow the 
client application to either cancel the request or perform an actual color selection, the signal will pass an 
instance of the WebKitColorChooserRequest in the request argument. 


It is possible to handle this request asynchronously by increasing the reference count of the request. 


The default signal handler will asynchronously run a regular GtkColorChooser for the user to 
interact with. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.8 


Parameters 


request 


Type: |WebKitColorChooserRequest 


A WebKitColorChooserRequest. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 
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Signal 


WebKit2|Web View::run-file-chooser 


unstable since: 4.1 


Declaration 


gboolean 

run_file_chooser ( 
WebKitWebView* self, 
WebKitFileChooserRequest* request, 
gpointer user_data 

) 


Description 


This signal is emitted when the user interacts with a HTML element, requesting from WebKit to show a 
dialog to select one or more files to be uploaded. To let the application know the details of the file 
chooser, as well as to allow the client application to either cancel the request or perform an actual selection 
of files, the signal will pass an instance of the WebKitFileChooserRequest in the request 
argument. 


The default signal handler will asynchronously run a regular GUkKFileChooserDialog for the user to 
interact with. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


request 


Type: |WebKitFileChooserRequest 


A WebKitFileChooserRequest. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 


Generated by[gi-docgen|2023.3 


Signal 


WebKit2Web View;:script-dialog 


unstable since: 4.1 


Declaration 


gboolean 

script_dialog ( 
WebKitWebView* self, 
WebKitScriptDialog* dialog, 
gpointer user_data 

) 


Description 


Emitted when JavaScript code calls window.alert, window.confirm or window.prompt, or when 
onbeforeunload event is fired. The dialog parameter should be used to build the dialog. If the signal is 
not handled a different dialog will be built and shown depending on the dialog type: 
WEBKIT_SCRIPT_DIALOG_ALERT: message dialog with a single Close button. 
WEBKIT_SCRIPT_DIALOG_CONF IRM: message dialog with OK and Cancel buttons. 
WEBKIT_SCRIPT_DIALOG_PROMPT: message dialog with OK and Cancel buttons and a text entry 
with the default text. WEBKIT_SCRIPT_DIALOG_BEFORE_UNLOAD_CONF IRM: message dialog with 
Stay and Leave buttons. 


It is possible to handle the script dialog request asynchronously, by simply caling 
webkit_script_dialog_ref() onthe dialog argument and calling 
webkit_script_dialog_close() when done. If the last reference is removed ona 
WebKitScriptDialog and the dialog has not been closed, webkit_script_dialog_close() 
will be called. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


dialog 


Type:|WebKitScriptDialog 


The WebKitScriptDialog to show. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 


Generated by[gi-docgen|2023.3 


Signal 


WebKit2\Web View; :show-notification 


since: 2.8 


Declaration 


gboolean 

show_notification ( 
WebKitWebView* self, 
WebKitNotification* notification, 
gpointer user_data 

) 


Description 


This signal is emitted when a notification should be presented to the user. The notification is kept 
alive until either: 1) the web page cancels it or 2) a navigation happens. 


The default handler will emit a notification using libnotify, if built with support for it. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.8 


Parameters 


notification 


Type:|WebKitNotification 


A WebKitNotification. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked. FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 


Generated by[gi-docgen|2023.3 


Signal 


WebKit2|Web View::show-option-menu 


since: 2.18 


Declaration 


gboolean 

show_option_menu ( 
WebKitWebView* self, 
WebKitOptionMenu* menu, 
GdkEvent* event, 
GdkRectangle rectangle, 
gpointer user_data 


Description 


This signal is emitted when a select element in web_view needs to display a dropdown menu. This signal 


can be used to show a custom menu, using menu to get the details of all items that should be displayed. 
The area of the element in the WebKitWebView is given as rectangle parameter, it can be used to 
position the menu. If this was triggered by a user interaction, like a mouse click, event parameter 
provides the GdkEvent. To handle this signal asynchronously you should keep a ref of the menu. 


The event parameter is now deprecated. Use webkit_option_menu_get_event () to get the 
GdkEvent that triggered the dropdown menu. 


The default signal handler will pop up a GtkMenu. 
Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.18 


Parameters 


menu 


Type:|(WebKitOptionMenu 


The WebKitOptionMenu. 


The data is owned by the caller of the function. 


event 
Type: GdkEvent 


The GdkEvent that triggered the menu, or NULL. Deprecated 2.40 


The data is owned by the caller of the function. 


rectangle 
Type: GdkRectangle 


The option element area. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 


Generated by[gi-docgen|2023.3 


Signal 


WebKit2WebView;:submit-form 


unstable since: 4.1 


Declaration 


void 

submit_form ( 
WebKitWebView* self, 
WebKitFormSubmissionRequest* request, 
gpointer user_data 

) 


Description 


This signal is emitted when a form is about to be submitted. The request argument passed contains 
information about the text fields of the form. This is typically used to store login information that can be 
used later to pre-fill the form. The form will not be submitted until 
webkit_form_submission_request_submit () is called. 


It is possible to handle the form submission request asynchronously, by simply calling 
g_object_ref() onthe request argument and calling 
webkit_form_submission_request_submit () when done to continue with the form 


submission. If the last reference is removed on a WebKitFormSubmissionRequest and the form has 
not been submitted, webkit_form_submission_request_submit () will be called. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 4.1 


Parameters 


request 


Type: |(WebKitFormSubmissionRequest 


A WebKitFormSubmissionRequest. 


The data is owned by the caller of the function. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 


Generated by[gi-docgen|2023.3 


Signal 


WebKit2\Web View: :user-message-received 


since: 2.28 


Declaration 


gboolean 

user_message_received ( 
WebKitWebView* self, 
WebKitUserMessage* message, 
gpointer user_data 

) 


Description 


This signal is emitted when a WebKitUserMessage is received from the WebKitWebPage 
corresponding to web_view. You can reply to the message using webkit_user_message_send_reply(). 


You can handle the user message asynchronously by calling g_object_ref () onmessage and 
returning TRUE. If the last reference of message is removed and the message has not been replied to, the 
operation in the WebKitWebPage will finish with error 
WEBKIT_USER_MESSAGE_UNHANDLED_MESSAGE. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.28 


Parameters 


message 


Type: |WebKitUserMessage 


The WebKitUserMessage received. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE if the message was handled, or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 


Generated by[gi-docgen|2023.3 


Signal 


WebKit2\Web View: :web-process-crashed 


unstable deprecated: 2.20 since: 4.1 


Declaration 


gboolean 

web_process_crashed ( 
WebKitWebView* self, 
gpointer user_data 


) 


Description 


This signal is emitted when the web process crashes. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 
Available since: 4.1 
Deprecated since: 2.20 


Use WebKitWebView::web-process-terminated instead. 


Return value 
Type: gboolean 


TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Signals 


web-process-terminated 


Generated by[gi-docgen|2023.3 


Signal 

WebKit2\Web View::web-process-terminated 
since: 2.20 

Declaration 

void 


web_process_terminated ( 
WebKitWebView* self, 
WebKitWebProcessTerminationReason reason, 
gpointer user_data 

) 


Description 


This signal is emitted when the web process terminates abnormally due to reason. 


Default handler: 


The default handler is called after the handlers added via g_signal_connect (). 


Available since: 2.20 


Parameters 


reason 


Type:\WebKitWebProcessTerminationReason 


The a WebKitWebProcessTerminationReason. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit3Web Viewauthenticate 
Declaration 


gboolean 

authenticate ( 
WebKitWebView* web_view, 
WebKitAuthenticationRequest* request 


) 


Description 


No description available. 


Parameters 


request 


Type:|(WebKitAuthenticationRequest 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2\WebViewclose 
Declaration 


void 
close ( 
WebKitWebView* web_view 


) 


Description 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewcontext_menu 
Declaration 


gboolean 

context_menu ( 
WebKitWebView* web_view, 
WebKitContextMenu* context_menu, 
GdkEvent* event, 
WebKitHitTestResult* hit_test_result 

) 


Description 


No description available. 


Parameters 


context_menu 


Type: |WebKitContextMenu 


No description available. 


The data is owned by the caller of the function. 


event 
Type: GdkEvent 


No description available. 


The data is owned by the caller of the function. 


hit_test_result 


Type:\(WebKitHitTestResult 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit | eb Viewcontext_menu_dismissed 
Declaration 


void 
context_menu_dismissed ( 
WebKitWebView* web_view 


) 


Description 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewcreate 
Declaration 


GtkWidget* 

create ( 
WebKitWebView* web_view, 
WebKitNavigationAction* navigation_action 


) 


Description 


No description available. 


Parameters 


navigation_action 


Type: \(WebKitNavigationAction 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: GtkWidget 


No description available. 


The data is owned by the called function. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2|WebViewdecide_policy 
Declaration 


gboolean 

decide_policy ( 
WebKitWebView* web_view, 
WebKitPolicyDecision* decision, 
WebKitPolicyDecisionType type 

) 


Description 


No description available. 


Parameters 


decision 


Type:|(WebKitPolicyDecision 


No description available. 


The data is owned by the caller of the function. 


type 


Type:|WebKitPolicyDecisionType 


No description available. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewenter_fullscreen 
Declaration 


gboolean 
enter_fullscreen ( 
WebKitWebView* web_view 


) 


Description 


No description available. 
Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewinsecure_content_detected 
Declaration 


void 
insecure_content_detected ( 
WebKitWebView* web_view, 
WebKitInsecureContentEvent event 
) 
° ° 
Description 


No description available. 


Parameters 


event 


Type: \(WebKitInsecureContentEvent 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewleave_fullscreen 
Declaration 


gboolean 
leave_fullscreen ( 
WebKitWebView* web_view 


) 


Description 


No description available. 
Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2ZWebViewload_changed 
Declaration 


void 

load_changed ( 
WebKitWebView* web_view, 
WebKitLoadEvent load_event 

) 


Description 


No description available. 


Parameters 


load_event 


Type:|WebKit LoadEvent 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewload_failed 
Declaration 


gboolean 

load_failed ( 
WebKitWebView* web_view, 
WebKitLoadEvent load_event, 
const gchar* failing_uri, 
GError* error 


Description 


No description available. 


Parameters 


load_event 


Type: |WebKit LoadEvent 


No description available. 


failing_uri 
Type: const gchar* 
No description available. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


error 
Type: GError 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewload_failed_with_tls_errors 
Declaration 


gboolean 

load_failed_with_tls_errors ( 
WebKitWebView* web_view, 
const gchar* failing_uri, 
GTlsCertificate* certificate, 
GTlsCertificateFlags errors 


Description 


No description available. 
Parameters 
failing_uri 


Type: const gchar* 


No description available. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


certificate 
Type: GTlsCertificate 


No description available. 


The data is owned by the caller of the function. 


errors 
Type: GTlsCertificateFlags 


No description available. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2ZWebViewmouse_target_changed 
Declaration 


void 

mouse_target_changed ( 
WebKitWebView* web_view, 
WebKitHitTestResult* hit_test_result, 
guint modifiers 


) 


Description 


No description available. 


Parameters 


hit_test_result 


Type:\(WebKitHitTestResult 


No description available. 
The data is owned by the caller of the function. 
modifiers 


Type: guint 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2\Web Viewpermission_request 
Declaration 


gboolean 

permission_request ( 
WebKitWebView* web_view, 
WebKitPermissionRequest* permission_request 


) 


Description 


No description available. 


Parameters 


permission_request 


Type: |(WebKitPermissionRequest 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2\WebViewprint 
Declaration 


gboolean 

print ( 
WebKitWebView* web_view, 
WebKitPrintOperation* print_operation 


) 


Description 


No description available. 


Parameters 


print_operation 


Type:\WebKitPrintOperation 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewquery_permission_state 
Declaration 


gboolean 

query_permission_state ( 
WebKitWebView* web_view, 
WebKitPermissionStateQuery* query 


) 


Description 


No description available. 
Parameters 


query 


Type:\WebKitPermissionStateQuery 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewready_to_show 
Declaration 


void 
ready_to_show ( 
WebKitWebView* web_view 


) 


Description 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2\WebViewresource_load_started 
Declaration 


void 

resource_load_started ( 
WebKitWebView* web_view, 
WebKitWebResource* resource, 
WebKitURIRequest* request 

) 


Description 


No description available. 


Parameters 


resource 


Type:|WebKitWebResource 


No description available. 


The data is owned by the caller of the function. 


request 


Type: |WebKitURIRequest 


No description available. 


The data is owned by the caller of the function. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewrun_as_modal 
Declaration 


void 
run_as_modal ( 
WebKitWebView* web_view 


) 


Description 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit | ebViewrun_color_chooser 
Declaration 


gboolean 


run_color_chooser ( 
WebKitWebView* web_view, 
WebKitColorChooserRequest* request 


) 


Description 


No description available. 


Parameters 


request 


Type: |WebKitColorChooserRequest 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewrun_file_chooser 
Declaration 


gboolean 


run_file_chooser ( 
WebKitWebView* web_view, 
WebKitFileChooserRequest* request 
) 


Description 


No description available. 


Parameters 


request 


Type: |WebKitFileChooserRequest 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewscript_dialog 
Declaration 


gboolean 

script_dialog ( 
WebKitWebView* web_view, 
WebKitScriptDialog* dialog 

) 


Description 


No description available. 


Parameters 


dialog 


Type:|WebKitScriptDialog 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewshow_notification 
Declaration 


gboolean 


show_notification ( 
WebKitWebView* web_view, 
WebKitNotification* notification 


) 


Description 


No description available. 


Parameters 


notification 


Type:\WebKitNotification 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewshow_option_menu 
Declaration 


gboolean 

show_option_menu ( 
WebKitWebView* web_view, 
WebKitOptionMenu* menu, 
GdkEvent* event, 
GdkRectangle* rectangle 


Description 


No description available. 


Parameters 


menu 


Type:|WebKitOptionMenu 


No description available. 


The data is owned by the caller of the function. 


event 
Type: GdkEvent 


No description available. 


The data is owned by the caller of the function. 


rectangle 
Type: GdkRectangle 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewsubmit_form 
Declaration 


void 

submit_form ( 
WebKitWebView* web_view, 
WebKitFormSubmissionRequest* request 


) 


Description 


No description available. 


Parameters 


request 


Type:|(WebKitFormSubmissionRequest 


No description available. 


The data is owned by the caller of the function. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit | eb Viewuser_message_received 
Declaration 


gboolean 

user_message_received ( 
WebKitWebView* web_view, 
WebKitUserMessage* message 


) 


Description 


No description available. 


Parameters 


message 


Type:|WebKitUserMessage 


No description available. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewweb_process_crashed 
Declaration 


gboolean 
web_process_crashed ( 
WebKitWebView* web_view 


) 


Description 


No description available. 
Return value 
Type: gboolean 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Virtual methods 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2WebViewweb_process_terminated 
Declaration 


void 

web_process_terminated ( 
WebKitWebView* web_view, 
WebKitWebProcessTerminationReason reason 


) 


Description 


No description available. 


Parameters 


reason 


Type:\WebKitWebProcessTerminationReason 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
WebViewBase 


Generated by[gi-docgen|2023.3 
Class 


WebKit2/\Web ViewBase 


unstable since: 4.1 


Description 


class WebKit2.WebViewBase : Gtk.Container 
implements Atk.ImplementorIface, Gtk.Buildable { 
priv: WebKitWebViewBasePrivate* 

} 


No description available. 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitWebViewBase implements_O AtkImplementorIface this--implements_0 
implements_1 GtkBuildable this--implements_1 ancestor_0 GtkContainer ancestor_0--this ancestor_1 
GtkWidget ancestor_1--ancestor_0 ancestor_2 GInitiallyUnowned ancestor_2--ancestor_1 ancestor_3 
GObject ancestor_3--ancestor_2 


Ancestors 


GtkContainer 
GtkWidget 
GInitially Unowned 
GObject 


Descendants 


@ |(WebKitWebView 
Implements 


@ AtkImplementorIface 
@ GtkBuildable 


Instance methods 

Methods inherited from GtkContainer (33) 
Please see GtkContainer for a full list of methods. 
Methods inherited from GtkWidget (263) 

Please see Gtk Widget for a full list of methods. 
Methods inherited from GObject (43) 

Please see GObject for a full list of methods. 

Methods inherited from GtkBuildable (10) 
gtk_buildable_add_child 

Adds a child to buildable. type is an optional string describing how the child should be added. 
since: 2.12 

gtk_buildable_construct_child 

Constructs a child of buildable with the name name. 
since: 2.12 

gtk_buildable_custom_finished 


This is similar to gtk_buildable_parser_finished() but is called once for each custom tag 
handled by the buildable. 


since: 2.12 
gtk_buildable_custom_tag_end 


This is called at the end of each custom element handled by the buildable. 


since: 2.12 

gtk_buildable_custom_tag_start 

This is called for each unknown element under <child>. 
since: 2.12 

gtk_buildable_get_internal_child 

Get the internal child called childname of the buildable object. 
since: 2.12 

gtk_buildable_get_name 

Gets the name of the buildable object. 

since: 2.12 

gtk_buildable_parser_finished 


Called when the builder finishes the parsing of a [GtkBuilder UI definition][BUILDER-UI]. Note that this 
will be called once for each time gtk_builder_add_from_file() or 
gtk_builder_add_from_string() is called on a builder. 


since: 2.12 

gtk_buildable_set_buildable_property 

Sets the property name name to value on the buildable object. 
since: 2.12 

gtk_buildable_set_name 

Sets the name of the buildable object. 


since: 2.12 


Properties 


Properties inherited from GtkContainer (3) 


Gtk.Container:border-width 


No description available. 


unstable since: 3.0 


Gtk.Container: child 


No description available. 
unstable since: 3.0 


Gtk.Container:resize-mode 


No description available. 
unstable since: 3.0 


Properties inherited from GtkWidget (39) 
Gtk. Widget:app-paintable 


No description available. 
unstable since: 3.0 


Gtk. Widget:can-default 


No description available. 
unstable since: 3.0 


Gtk. Widget:can-focus 


No description available. 
unstable since: 3.0 


Gtk.Widget:composite-child 


No description available. 

unstable since: 3.0 

Gtk. Widget:double-buffered 
Whether the widget is double buffered. 
deprecated: 3.14 since: 2.18 


Gtk.Widget:events 


No description available. 


unstable since: 3.0 


Gtk. Widget:expand 


Whether to expand in both directions. Setting this sets both GtkWidget :hexpand and 
GtkWidget : vexpand. 


unstable since: 3.0 

Gtk. Widget:focus-on-click 

Whether the widget should grab focus when it is clicked with the mouse. 
unstable since: 3.20 

Gtk. Widget:halign 

How to distribute horizontal space if widget gets extra space, see GtkAlign. 
unstable since: 3.0 


Gtk. Widget:has-default 


No description available. 
unstable since: 3.0 


Gtk.Widget:has-focus 


No description available. 
unstable since: 3.0 
Gtk. Widget:has-tooltip 


Enables or disables the emission of GtkWidget: :query-tooltip on widget. A value of TRUE 
indicates that widget can have a tooltip, in this case the widget will be queried using 
GtkWidget: :query-tooltip to determine whether it will provide a tooltip or not. 


since: 2.12 


Gtk. Widget:height-request 


No description available. 
unstable since: 3.0 
Gtk.Widget:hexpand 


Whether to expand horizontally. See gtk_widget_set_hexpand(). 


unstable since: 3.0 

Gtk. Widget:hexpand-set 

Whether to use the GtkWidget :hexpand property. See gtk_widget_get_hexpand_set(). 
unstable since: 3.0 


Gtk. Widget:is-focus 


No description available. 

unstable since: 3.0 

Gtk.Widget:margin 

Sets all four sides’ margin at once. If read, returns max margin on any side. 
unstable since: 3.0 

Gtk.Widget:margin-bottom 

Margin on bottom side of widget. 

unstable since: 3.0 

Gtk.Widget:margin-end 

Margin on end of widget, horizontally. This property supports left-to-right and right-to-left text directions. 
unstable since: 3.12 

Gtk. Widget:margin-left 

Margin on left side of widget. 

unstable deprecated: 3.12 since: 3.0 

Gtk. Widget:margin-right 

Margin on right side of widget. 

unstable deprecated: 3.12 since: 3.0 

Gtk. Widget:margin-start 


Margin on start of widget, horizontally. This property supports left-to-right and right-to-left 
text directions. 


unstable since: 3.12 
Gtk.Widget:margin-top 
Margin on top side of widget. 
unstable since: 3.0 


Gtk.Widget:name 


No description available. 
unstable since: 3.0 


Gtk. Widget:no-show-all 


No description available. 
unstable since: 3.0 
Gtk. Widget: opacity 


The requested opacity of the widget. See gtk_widget_set_opacity () for more details about 
window opacity. 


unstable since: 3.8 


Gtk.Widget:parent 


No description available. 
unstable since: 3.0 


Gtk. Widget:receives-default 


No description available. 
unstable since: 3.0 
Gtk. Widget:scale-factor 


The scale factor of the widget. See gtk_widget_get_scale_factor() for more details about 
widget scaling. 


unstable since: 3.10 


Gtk. Widget:sensitive 


No description available. 


unstable since: 3.0 

Gtk.Widget:style 

The style of the widget, which contains information about how it will look (colors, etc). 
unstable deprecated: Unknown since: 3.0 

Gtk. Widget:tooltip-markup 


Sets the text of tooltip to be the given string, which is marked up with the [Pango text markup 
language ][PangoMarkupFormat]. Also see gtk_tooltip_set_markup(Q). 


since: 2.12 

Gtk. Widget:tooltip-text 

Sets the text of tooltip to be the given string. 

since: 2.12 

Gtk. Widget:valign 

How to distribute vertical space if widget gets extra space, see GtkAlign. 
unstable since: 3.0 

Gtk. Widget:vexpand 

Whether to expand vertically. See gtk_widget_set_vexpand(). 

unstable since: 3.0 

Gtk. Widget: vexpand-set 

Whether to use the GtkWidget : vexpand property. See gtk_widget_get_vexpand_set(). 
unstable since: 3.0 


Gtk. Widget: visible 


No description available. 
unstable since: 3.0 


Gtk. Widget: width-request 


No description available. 


unstable since: 3.0 
Gtk.Widget:window 
The widget’s window if it is realized, NULL otherwise. 


since: 2.14 


Signals 
Signals inherited from GtkContainer (4) 
GtkContainer::add 


No description available. 
unstable since: 3.0 


GtkContainer::check-resize 


No description available. 
unstable since: 3.0 


GtkContainer::remove 


No description available. 
unstable since: 3.0 


GtkContainer::set-focus-child 


No description available. 
unstable since: 3.0 


Signals inherited from GtkWidget (69) 


GtkWidget::accel-closures-changed 


No description available. 

unstable since: 3.0 

GtkWidget::button-press-event 

The ::button-press-event signal will be emitted when a button (typically from a mouse) is pressed. 


unstable since: 3.0 


GtkWidget: :button-release-event 

The ::button-release-event signal will be emitted when a button (typically from a mouse) is released. 
unstable since: 3.0 

GtkWidget::can-activate-accel 


Determines whether an accelerator that activates the signal identified by signal_idcan currently be 
activated. This signal is present to allow applications and derived widgets to override the default 
GtkWidget handling for determining whether an accelerator can be activated. 


unstable since: 3.0 
GtkWidget::child-notify 


The ::child-notify signal is emitted for each [child property][child-properties] that has changed on an 
object. The signal’s detail holds the property name. 


unstable since: 3.0 
GtkWidget::composited-changed 


The ::composited-changed signal is emitted when the composited status of widgets screen changes. 
See gdk_screen_is_composited(). 


unstable deprecated: 3.22 since: 3.0 
GtkWidget::configure-event 


The ::configure-event signal will be emitted when the size, position or stacking of the widget ‘s window 
has changed. 


unstable since: 3.0 
GtkWidget::damage-event 


Emitted when a redirected window belonging to widget gets drawn into. The region/area members of the 
event shows what area of the redirected drawable was drawn into. 


since: 2.14 
GtkWidget::delete-event 


The ::delete-event signal is emitted if a user requests that a toplevel window is closed. The default handler 
for this signal destroys the window. Connecting gtk_widget_hide_on_delete () to this signal will 
cause the window to be hidden instead, so that it can later be shown again without reconstructing it. 


unstable since: 3.0 
GtkWidget::destroy 


Signals that all holders of a reference to the widget should release the reference that they hold. May result 
in finalization of the widget if all references are released. 


unstable since: 3.0 
GtkWidget::destroy-event 


The ::destroy-event signal is emitted when a GdkWindow is destroyed. You rarely get this signal, because 
most widgets disconnect themselves from their window before they destroy it, so no widget owns the 
window at destroy time. 


unstable since: 3.0 

GtkWidget::direction-changed 

The ::direction-changed signal is emitted when the text direction of a widget changes. 
unstable since: 3.0 

GtkWidget::drag-begin 


The ::drag-begin signal is emitted on the drag source when a drag is started. A typical reason to connect to 
this signal is to set up a custom drag icon with e.g. gtk_drag_source_set_icon_pixbuf(). 


unstable since: 3.0 
GtkWidget::drag-data-delete 


The ::drag-data-delete signal is emitted on the drag source when a drag with the action 
GDK_ACTION_MOVE is successfully completed. The signal handler is responsible for deleting the data 
that has been dropped. What “delete” means depends on the context of the drag operation. 


unstable since: 3.0 
GtkWidget::drag-data-get 


The ::drag-data-get signal is emitted on the drag source when the drop site requests the data which is 
dragged. It is the responsibility of the signal handler to fill data with the data in the format which is 
indicated by info. See gtk_selection_data_set () and gtk_selection_data_set_text(). 


unstable since: 3.0 


GtkWidget::drag-data-received 


The ::drag-data-received signal is emitted on the drop site when the dragged data has been received. If the 
data was received in order to determine whether the drop will be accepted, the handler is expected to call 
gdk_drag_status () and not finish the drag. If the data was received in response to a 

GtkWidget: :drag-—drop signal (and this is the last target to be received), the handler for this signal is 
expected to process the received data and then call gtk_drag_finishQ, setting the success parameter 
depending on whether the data was processed successfully. 


unstable since: 3.0 
GtkWidget::drag-drop 


The ::drag-drop signal is emitted on the drop site when the user drops the data onto the widget. The signal 
handler must determine whether the cursor position is in a drop zone or not. If it is not in a drop zone, it 
returns FALSE and no further processing is necessary. Otherwise, the handler returns TRUE. In this case, 
the handler must ensure that gtk_drag_finish () is called to let the source know that the drop is 
done. The call to gtk_drag_finish() can be done either directly or in a 

GtkWidget: :drag-data-received handler which gets triggered by calling 
gtk_drag_get_data() to receive the data for one or more of the supported targets. 


unstable since: 3.0 
GtkWidget::drag-end 


The ::drag-end signal is emitted on the drag source when a drag is finished. A typical reason to connect to 
this signal is to undo things done in GtkWidget : :drag—begin. 


unstable since: 3.0 
GtkWidget::drag-failed 


The ::drag-failed signal is emitted on the drag source when a drag has failed. The signal handler may hook 
custom code to handle a failed DnD operation based on the type of error, it returns TRUE is the failure has 
been already handled (not showing the default “drag operation failed” animation), otherwise it returns 
FALSE. 


since: 2.12 
GtkWidget::drag-leave 


The ::drag-leave signal is emitted on the drop site when the cursor leaves the widget. A typical reason to 
connect to this signal is to undo things done in GtkWidget : :drag-—motion, e.g. undo highlighting 
with gtk_drag_unhighlight(). 


unstable since: 3.0 


GtkWidget::drag-motion 


The ::drag-motion signal is emitted on the drop site when the user moves the cursor over the widget during 
a drag. The signal handler must determine whether the cursor position is in a drop zone or not. If it is not 
in a drop zone, it returns FALSE and no further processing is necessary. Otherwise, the handler returns 
TRUE. In this case, the handler is responsible for providing the necessary information for displaying 
feedback to the user, by calling gdk_drag_status(). 


unstable since: 3.0 
GtkWidget::draw 


This signal is emitted when a widget is supposed to render itself. The widget ‘s top left corner must be 
painted at the origin of the passed in context and be sized to the values returned by 
gtk_widget_get_allocated_width () and gtk_widget_get_allocated_height(). 


unstable since: 3.0 

GtkWidget::enter-notify-event 

The ::enter-notify-event will be emitted when the pointer enters the widget ‘s window. 
unstable since: 3.0 

GtkWidget::event 


The GTK+ main loop will emit three signals for each GDK event delivered to a widget: one generic 
s:event signal, another, more specific, signal that matches the type of event delivered (e.g. 
GtkWidget: :key—press-—event) and finally a generic GtkWidget: :event-after signal. 


unstable since: 3.0 
GtkWidget::event-after 


After the emission of the GtkWidget: :event signal and (optionally) the second more specific signal, 
sevent-after will be emitted regardless of the previous two signals handlers return values. 


unstable since: 3.0 


GtkWidget::focus 


No description available. 


unstable since: 3.0 


GtkWidget: :focus-in-event 

The ::focus-in-event signal will be emitted when the keyboard focus enters the widget ‘s window. 
unstable since: 3.0 

GtkWidget: :focus-out-event 

The ::focus-out-event signal will be emitted when the keyboard focus leaves the widget ‘s window. 
unstable since: 3.0 

GtkWidget::grab-broken-event 

Emitted when a pointer or keyboard grab on a window belonging to widget gets broken. 

since: 2.8 


GtkWidget::grab-focus 


No description available. 
unstable since: 3.0 
GtkWidget::grab-notify 


The ::grab-notify signal is emitted when a widget becomes shadowed by a GTK+ grab (not a pointer or 
keyboard grab) on another widget, or when it becomes unshadowed due to a grab being removed. 


unstable since: 3.0 

GtkWidget: :hide 

The ::hide signal is emitted when widget is hidden, for example with gtk_widget_hide(). 
unstable since: 3.0 

GtkWidget: :hierarchy-changed 


The ::hierarchy-changed signal is emitted when the anchored state of a widget changes. A widget is 
aanchoreda when its toplevel ancestor is a Gt kWindow. This signal is emitted when a widget changes 
from un-anchored to anchored or vice-versa. 


unstable since: 3.0 
GtkWidget::key-press-event 


The ::key-press-event signal is emitted when a key is pressed. The signal emission will reoccur at the 
key-repeat rate when the key is kept pressed. 


unstable since: 3.0 

GtkWidget: :key-release-event 

The ::key-release-event signal is emitted when a key is released. 

unstable since: 3.0 

GtkWidget::keynav-failed 

Gets emitted if keyboard navigation fails. See gtk_widget_keynav_failed() for details. 
since: 2.12 

GtkWidget::leave-notify-event 

The ::leave-notify-event will be emitted when the pointer leaves the widget ‘s window. 
unstable since: 3.0 

GtkWidget::map 


The ::map signal is emitted when widget is going to be mapped, that is when the widget is visible 
(which is controlled with gtk_widget_set_visible()) and all its parents up to the toplevel widget are also 
visible. Once the map has occurred, GtkWidget: :map-—event will be emitted. 


unstable since: 3.0 
GtkWidget::map-event 


The ::map-event signal will be emitted when the widget ‘s window is mapped. A window is mapped 
when it becomes visible on the screen. 


unstable since: 3.0 
GtkWidget: :mnemonic-activate 


The default handler for this signal activates widget if group_cycling is FALSE, or just makes 
widget grab focus if group_cycling is TRUE. 


unstable since: 3.0 
GtkWidget: :motion-notify-event 
The ::motion-notify-event signal is emitted when the pointer moves over the widget’s GdkWindow. 


unstable since: 3.0 


GtkWidget::move-focus 


No description available. 

unstable since: 3.0 

GtkWidget::parent-set 

The ::parent-set signal is emitted when a new parent has been set on a widget. 
unstable since: 3.0 

GtkWidget::popup-menu 


This signal gets emitted whenever a widget should pop up a context menu. This usually happens through 
the standard key binding mechanism; by pressing a certain key while a widget is focused, the user can 
cause the widget to pop up a menu. For example, the GtkEnt ry widget creates a menu with clipboard 
commands. See the [Popup Menu Migration Checklist][checklist-popup-menu] for an example of how to 
use this signal. 


unstable since: 3.0 
GtkWidget::property-notify-event 


The ::property-notify-event signal will be emitted when a property on the widget ‘s window has been 
changed or deleted. 


unstable since: 3.0 
GtkWidget::proximity-in-event 


To receive this signal the GdkWindow associated to the widget needs to enable the 
#GDK_PROXIMITY_IN_MASK mask. 


unstable since: 3.0 
GtkWidget::proximity-out-event 


To receive this signal the GdkWindow associated to the widget needs to enable the 
#GDK_PROXIMITY_OUT_MASK mask. 


unstable since: 3.0 
GtkWidget::query-tooltip 


Emitted when GtkWidget :has—tooltip is TRUE and the hover timeout has expired with the cursor 
hovering “above” widget; or emitted when widget got focus in keyboard mode. 


since: 2.12 
GtkWidget::realize 


The ::realize signal is emitted when widget is associated with a GdkWindow, which means that 
gtk_widget_realize() has been called or the widget has been mapped (that is, it is going to 
be drawn). 


unstable since: 3.0 

GtkWidget::screen-changed 

The ::screen-changed signal gets emitted when the screen of a widget has changed. 
unstable since: 3.0 

GtkWidget::scroll-event 


The ::scroll-event signal is emitted when a button in the 4 to 7 range is pressed. Wheel mice are usually 
configured to generate button press events for buttons 4 and 5 when the wheel is turned. 


unstable since: 3.0 
GtkWidget::selection-clear-event 


The ::selection-clear-event signal will be emitted when the the widget ‘s window has lost ownership of 
a selection. 


unstable since: 3.0 


GtkWidget::selection-get 


No description available. 
unstable since: 3.0 


GtkWidget::selection-notify-event 


No description available. 
unstable since: 3.0 


GtkWidget::selection-received 


No description available. 


unstable since: 3.0 


GtkWidget::selection-request-event 


The ::selection-request-event signal will be emitted when another client requests ownership of the 
selection owned by the widget ‘s window. 


unstable since: 3.0 
GtkWidget::show 
The ::show signal is emitted when widget is shown, for example with gtk_widget_show(). 
unstable since: 3.0 


GtkWidget::show-help 


No description available. 
unstable since: 3.0 


GtkWidget: :size-allocate 


No description available. 

unstable since: 3.0 

GtkWidget: :state-changed 

The ::state-changed signal is emitted when the widget state changes. See gtk_widget_get_state(). 
unstable deprecated: 3.0 since: 3.0 

GtkWidget::state-flags-changed 


The ::state-flags-changed signal is emitted when the widget state changes, 
see gtk_widget_get_state_flags(). 


unstable since: 3.0 
GtkWidget::style-set 


The ::style-set signal is emitted when a new style has been set on a widget. Note that style-modifying 
functions like gtk_widget_modify_base() also cause this signal to be emitted. 


unstable deprecated: 3.0 since: 3.0 
GtkWidget::style-updated 


The ::style-updated signal is a convenience signal that is emitted when the 
GtkStyleContext: : changed signal is emitted on the widget ‘s associated GtkSt yleContext 
as returned by gtk_widget_get_style_context(). 


unstable since: 3.0 


GtkWidget::touch-event 


No description available. 
unstable since: 3.0 
GtkWidget::unmap 


The ::unmap signal is emitted when widget is going to be unmapped, which means that either it or any 
of its parents up to the toplevel widget have been set as hidden. 


unstable since: 3.0 
GtkWidget::unmap-event 


The ::unmap-event signal will be emitted when the widget ‘s window is unmapped. A window is 
unmapped when it becomes invisible on the screen. 


unstable since: 3.0 
GtkWidget::unrealize 


The ::unrealize signal is emitted when the GdkWindow associated with widget is destroyed, which 
means that gtk_widget_unrealize() has been called or the widget has been unmapped (that is, it is 
going to be hidden). 


unstable since: 3.0 

GtkWidget:: visibility-notify-event 

The ::visibility-notify-event will be emitted when the widget ‘s window is obscured or unobscured. 
unstable deprecated: 3.12 since: 3.0 

GtkWidget::window-state-event 


The ::window-state-event will be emitted when the state of the toplevel window associated to the widget 
changes. 


unstable since: 3.0 
Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2WebViewBaseClass { 
GtkContainerClass parentClass; 
void (* _webkit_reserved0) ( 
void 
i 
void (* _webkit_reservedl) ( 
void 
i 
void (* _webkit_reserved2) ( 
void 
i 
void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parentClass: GtkContainerClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 


Instance methods 


get_fullscreen set_locationbar_visible|get_menubar_visible 
get_scrollbars_visible]get_statusbar_visible]get_toolbar_visible' 


Properties 


locationbar-visible scrollbars-visible[statusbar-visible 
toolbar-visible 


Generated by 2023.3 
Class 


W ebKit2/WindowProperties 


unstable since: 4.1 


Description 


class WebKit2.WindowProperties : GObject.Object 
{ 


priv: WebKitWindowPropertiesPrivate* 


} 
Window properties of aWebKitWebView. 


The content of a WebKitWebView can request to change certain properties of the window containing the 
view. This can include the x, y position of the window, the width and height but also if a toolbar, scrollbar, 
statusbar, locationbar should be visible to the user, and the request to show the WebKitWebView 
fullscreen. 


The WebKitWebView: : ready—to-show signal handler is the proper place to apply the initial 
window properties. Then you can monitor the WebKitWindowProperties by connecting to 
smotify signal. 


static void ready_to_show_cb (WebKitWebView *web_view, gpointer user_data) 
{ 

GtkWidget *window; 

WebKitWindowProperties *window_properties; 

gboolean visible; 


// Create the window to contain the WebKitWebView. 

window = browser_window_new (); 

gtk_container_add (GTK_CONTAINER (window), GTK_WIDGET (web_view) ); 
gtk_widget_show (GTK_WIDGET (web_view) ); 


// Get the WebKitWindowProperties of the web view and monitor it. 
window_properties = webkit_web_view_get_window_properties (web_view) ; 
g_signal_connect (window_properties, "notify::geometry", 

G_CALLBACK (window_geometry_changed), window) ; 
g_signal_connect (window_properties, "notify::toolbar-visible", 

G_CALLBACK (window_toolbar_visibility_changed), window) ; 
g_signal_connect (window_properties, "notify::menubar-visible", 

G_CALLBACK (window_menubar_visibility_changed), window) ; 


// Apply the window properties before showing the window. 

visible = webkit_window_properties_get_toolbar_visible (window_properties) ; 
browser_window_set_toolbar_visible (BROWSER_WINDOW (window), visible); 
visible = webkit_window_properties_get_menubar_visible (window_properties) ; 
browser_window_set_menubar_visible (BROWSER_WINDOW (window), visible); 


if (webkit_window_properties_get_fullscreen (window_properties)) { 
gtk_window_fullscreen (GTK_WINDOW (window) ); 
} else { 
GdkRectangle geometry; 
gtk_window_set_resizable (GTK_WINDOW (window), 
webkit_window_properties_get_resizable (window_properties) ); 
webkit_window_properties_get_geometry (window_properties, &geometry) ; 


gtk_window_move (GTK_WINDOW (window), geometry.x, geometry.y); 
gtk_window_resize (GTK_WINDOW (window), geometry.width, geometry.height) ; 


gtk_widget_show (window) ; 


Available since: 4.1 


Hierarchy 


hierarchy this WebKitWindowProperties ancestor_0 GObject ancestor_O--this 


Ancestors 


@ GObject 


Instance methods 


webkit_window_properties_get_fullscreen 


Get whether the window should be shown in fullscreen state or not. 
unstable since: 4.1 
Get the geometry the window should have on the screen when shown. 


unstable since: 4.1 


webkit_window_properties_get_locationbar_visible 


Get whether the window should have the locationbar visible or not. 


unstable since: 4.1 


webkit_window_properties_get_menubar_visible 


Get whether the window should have the menubar visible or not. 
unstable since: 4.1 
Get whether the window should be resizable by the user or not. 


unstable since: 4.1 


webkit_window_properties_get_scrollbars_visible 


Get whether the window should have the scrollbars visible or not. 


unstable since: 4.1 


webkit_window_properties_get_statusbar_visible 


Get whether the window should have the statusbar visible or not. 


unstable since: 4.1 


webkit_window_properties_get_toolbar_visible 


Get whether the window should have the toolbar visible or not. 


unstable since: 4.1 


Methods inherited from GObject (43) 


Please see GObject for a full list of methods. 


Properties 


WebKit2.WindowProperties:fullscreen 


Whether window will be displayed fullscreen. 
unstable since: 4.1 
The size and position of the window on the screen. 


unstable since: 4.1 


WebKit2.WindowProperties:locationbar-visible 


Whether the locationbar should be visible for the window. 


unstable since: 4.1 


WebKit2.WindowProperties:menubar-visible 


Whether the menubar should be visible for the window. 
unstable since: 4.1 

Whether the window can be resized. 

unstable since: 4.1 

Whether the scrollbars should be visible for the window. 


unstable since: 4.1 


WebKit2.WindowProperties:statusbar-visible 


Whether the statusbar should be visible for the window. 


unstable since: 4.1 


Whether the toolbar should be visible for the window. 


unstable since: 4.1 


Signals 


Signals inherited from GObject (1) 
GObject::notify 


The notify signal is emitted on an object when one of its properties has its value set through 
g_object_set_property(), g_object_set(), et al. 


since: 2.0 


Class structure 


struct WebKit2WindowPropertiesClass { 
GObjectClass parent_class; 
void (* _webkit_reserved0) ( 

void 


void (* _webkit_reservedl) ( 


void (* _webkit_reserved2) ( 
void 

i 

void (* _webkit_reserved3) ( 
void 


i 


} 


No description available. 
Class members 


parent_class: GObjectClass 
No description available. 

_webkit_reserved0: void (* _webkit_reserved0) ( void ) 
No description available. 

_webkit_reservedl: void (* _webkit_reservedl) ( void ) 
No description available. 

_webkit_reserved2: void (* _webkit_reserved2) ( void ) 
No description available. 

_webkit_reserved3: void (* _webkit_reserved3) ( void ) 
No description available. 
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Method 


WebKit2WindowPropertiesget_fullscreen 
Declaration 


gboolean 
webkit_window_properties_get_fullscreen ( 
WebKitWindowProperties* window_properties 


) 


Description 


Get whether the window should be shown in fullscreen state or not. 


Gets property |WebKit2.WindowProperties: fullscreen 


Return value 
Type: gboolean 


TRUE if the window should be fullscreen or FALSE otherwise. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
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Methods 


get_fullscreen set_locationbar_visible|get_menubar_visible 
get_scrollbars_visible]get_statusbar_visible]get_toolbar_visible’ 
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Method 


WebKit2WindowPropertiesget_geometry 
Declaration 


void 


webkit_window_properties_get_geometry ( 
WebKitWindowProperties* window_properties, 
GdkRectangle* geometry 

) 


Description 


Get the geometry the window should have on the screen when shown. 


Gets property |WebKit2.WindowProperties: geometry 


Parameters 
geometry 
Type: GdkRectangle 


Return location for the window geometry. 


The argument will be set by the function. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


get_fullscreen set_locationbar_visible|get_menubar_visible 
get_scrollbars_visible]get_statusbar_visible]get_toolbar_visible’ 


Generated by[gi-docgen]2023.3 
Method 


WebKit J indowPropertiesget_locationbar_visible 
Declaration 


gboolean 
webkit_window_properties_get_locationbar_visible ( 
WebKitWindowProperties* window_properties 


) 


Description 


Get whether the window should have the locationbar visible or not. 


Gets property |WebKit2.WindowProperties:locationbar-visible 


Return value 
Type: gboolean 


TRUE if locationbar should be visible or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


get_fullscreen set_locationbar_visible|get_menubar_visible 
get_scrollbars_visible]get_statusbar_visible]get_toolbar_visible’ 


Generated by[gi-docgen]2023.3 
Method 


WebKit J indowPropertiesget_menubar_visible 
Declaration 


gboolean 
webkit_window_properties_get_menubar_visible ( 
WebKitWindowProperties* window_properties 


) 


Description 


Get whether the window should have the menubar visible or not. 


Gets property |WebKit2.WindowProperties:menubar-visible 


Return value 
Type: gboolean 


TRUE if menubar should be visible or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


get_fullscreen set_locationbar_visible|get_menubar_visible 
get_scrollbars_visible]get_statusbar_visible]get_toolbar_visible’ 


Generated by[gi-docgen]2023.3 
Method 


WebKit2WindowPropertiesget_resizable 
Declaration 


gboolean 
webkit_window_properties_get_resizable ( 
WebKitWindowProperties* window_properties 


) 


Description 


Get whether the window should be resizable by the user or not. 


Gets property |WebKit2.WindowProperties:resizable 


Return value 
Type: gboolean 


TRUE if the window should be resizable or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


get_fullscreen set_locationbar_visible|get_menubar_visible 
get_scrollbars_visible]get_statusbar_visible]get_toolbar_visible’ 


Generated by[gi-docgen]2023.3 
Method 


WebKit J indowPropertiesget_scrollbars_visible 
Declaration 


gboolean 
webkit_window_properties_get_scrollbars_visible ( 
WebKitWindowProperties* window_properties 


) 


Description 


Get whether the window should have the scrollbars visible or not. 


Gets property |WebKit2.WindowProperties:scrollbars-visible 


Return value 
Type: gboolean 


TRUE if scrollbars should be visible or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


get_fullscreen set_locationbar_visible|get_menubar_visible 
get_scrollbars_visible]get_statusbar_visible]get_toolbar_visible’ 


Generated by[gi-docgen]2023.3 
Method 


WebKit J indowPropertiesget_statusbar_visible 
Declaration 


gboolean 
webkit_window_properties_get_statusbar_visible ( 
WebKitWindowProperties* window_properties 


) 


Description 


Get whether the window should have the statusbar visible or not. 


Gets property |WebKit2.WindowProperties:statusbar-visible 


Return value 
Type: gboolean 


TRUE if statusbar should be visible or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 


get_fullscreen set_locationbar_visible|get_menubar_visible 
get_scrollbars_visible]get_statusbar_visible]get_toolbar_visible’ 


Generated by[gi-docgen]2023.3 
Method 


WebKit J indowPropertiesget_toolbar_visible 
Declaration 


gboolean 
webkit_window_properties_get_toolbar_visible ( 
WebKitWindowProperties* window_properties 


) 


Description 


Get whether the window should have the toolbar visible or not. 


Gets property |WebKit2.WindowProperties:toolbar-visible 


Return value 
Type: gboolean 


TRUE if toolbar should be visible or FALSE otherwise. 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Properties 


locationbar-visible scrollbars-visible[statusbar-visible 


toolbar-visible 


Generated by[gi-docgen]2023.3 


Property 


WebKit2WindowPropertiestfullscreen 


unstable since: 4.1 


Declaration 


property fullscreen: gboolean [ read, write, construct-only ] 


Description 


Whether window will be displayed fullscreen. 


Type: gboolean 


Available since: 4.1 


Default value FALSE 


Getter method |webkit_window_properties_get_fullscreen() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Properties 


locationbar-visible scrollbars-visible[statusbar-visible 


toolbar-visible 


Generated by[gi-docgen]2023.3 


Property 


WebKit2WindowPropertiest geometry 


unstable since: 4.1 


Declaration 


property geometry: Gdk.Rectangle [ read, write, construct-only ] 


Description 


The size and position of the window on the screen. 


Type: GdkRectangle 


Available since: 4.1 


Getter method |webkit_window_properties_get_geometry () 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Properties 


locationbar-visible scrollbars-visible[statusbar-visible 


toolbar-visible 


Generated by[gi-docgen]2023.3 


Property 


WebKit2WindowPropertiestlocationbar-visible 


unstable since: 4.1 


Declaration 


property locationbar-visible: gboolean [ read, write, construct-only ] 


Description 


Whether the locationbar should be visible for the window. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_window_properties_get_locationbar_visible() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Properties 


locationbar-visible scrollbars-visible[statusbar-visible 


toolbar-visible 


Generated by[gi-docgen]2023.3 


Property 


WebKit2WindowPropertiestmenubar-visible 


unstable since: 4.1 


Declaration 


property menubar-visible: gboolean [ read, write, construct-only ] 


Description 


Whether the menubar should be visible for the window. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 
Getter method |webkit_window_properties_get_menubar_visible() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Properties 


locationbar-visible scrollbars-visible[statusbar-visible 


toolbar-visible 


Generated by[gi-docgen]2023.3 


Property 


WebKit2WindowPropertiestresizable 


unstable since: 4.1 


Declaration 


property resizable: gboolean [ read, write, construct-only ] 


Description 


Whether the window can be resized. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 
Getter method |webkit_window_properties_get_resizable() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Properties 


locationbar-visible scrollbars-visible[statusbar-visible 


toolbar-visible 


Generated by[gi-docgen]2023.3 


Property 


WebKit2WindowPropertiestscrollbars-visible 


unstable since: 4.1 


Declaration 


property scrollbars-visible: gboolean [| read, write, construct-only ] 


Description 


Whether the scrollbars should be visible for the window. 


Type: gboolean 


Available since: 4.1 


Default value TRUE 
Getter method |webkit_window_properties_get_scrollbars_visible() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Properties 


locationbar-visible scrollbars-visible[statusbar-visible 


toolbar-visible 


Generated by[gi-docgen]2023.3 


Property 


WebKit2ZWindowPropertieststatusbar-visible 


unstable since: 4.1 


Declaration 


property statusbar-visible: gboolean [ read, write, construct-only ] 


Description 


Whether the statusbar should be visible for the window. 
Type: gboolean 


Available since: 4.1 


Default value TRUE 
Getter method |webkit_window_properties_get_statusbar_visible() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Properties 


locationbar-visible scrollbars-visible[statusbar-visible 


toolbar-visible 


Generated by[gi-docgen]2023.3 


Property 


WebKit2WindowPropertiesttoolbar-visible 


unstable since: 4.1 


Declaration 


property toolbar-visible: gboolean [ read, write, construct-only ] 


Description 


Whether the toolbar should be visible for the window. 
Type: gboolean 


Available since: 4.1 


Default value TRUE 


Getter method |webkit_window_properties_get_toolbar_visible() 


Flags 


Readable 
Writable 
Construct 


Construct only 


yes 
yes 
no 


yes 


= 
S 
z 
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API Version: 4.1 


Library Version: 2.42.4 


Type 


PermissionRequest 


Instance methods 


den 


i) 

= 
H 

= 


Virtual methods 


den 
Generated by[gi-docgen]2023.3 


Interface 


WebKit2PermissionRequest 

unstable since: 4.1 

Description 

interface WebKit2.PermissionRequest : GObject.Object 
A permission request. 


There are situations where an embedder would need to ask the user for permission to do certain types of 
operations, such as switching to fullscreen mode or reporting the user’s location through the standard 
Geolocation API. In those cases, WebKit will emit a WebKitWebView: :permission-request 
signal with aWebKitPermissionRequest object attached to it. 


Available since: 4.1 
Prerequisite 


In order to implement PermissionRequest, your type must inherit fromGOb ject. 


Implementations 


WebKitClipboardPermissionRequest 
WebKitDeviceInfoPermissionRequest 
WebKitGeolocationPermissionRequest! 


WebKitWebsiteDataAccessPermissionRequest 


Instance methods 


webkit_permission_request_allow 


Allow the action which triggered this request. 


unstable since: 4.1 


webkit_permission_request_deny 


Deny the action which triggered this request. 


unstable since: 4.1 


Interface structure 


struct WebKit2PermissionRequestIface { 

GTypelInterface parent_interface; 

void (* allow) ( 
WebKitPermissionRequest* request 

i 

void (* deny) ( 
WebKitPermissionRequest* request 

i 


} 


No description available. 


Interface members 


parent_interface  GtypeInterface 
No description available. 
void (* allow) ( 


allow WebKitPermissionRequest* request 
) 


No description available. 
void (* deny) ( 


deny WebKitPermissionRequest* request 
) 


No description available. 


Virtual methods 


WebKit2.PermissionRequest.allow 


Allow the action which triggered this request. 
unstable since: 4.1 
[WebKit2.PermissionRequest.deny| 

Deny the action which triggered this request. 
unstable since: 4.1 


Content 


° 
e 
@ |Virtual methods 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


PermissionRequest 


Virtual methods 


den 
Generated by[gi-docgen|2023.3 


Virtual Method 


WebKit2PermissionRequestallow 
Declaration 


WebKitPermissionRequest* request 


Description 


Allow the action which triggered this request. 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


PermissionRequest 


Virtual methods 


den 


Generated by[gi-docgen|2023.3 
Virtual Method 


WebKit2PermissionRequestdeny 
Declaration 


i) 

= 
H 

= 


WebKitPermissionRequest* request 


Description 


Deny the action which triggered this request. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ApplicationInfo 


Constructors 


new 


Instance methods 


get_name}get_version|ref|set_name]set_versionjunre 
Generated by|gi-docgen}2023.3 


Struct 


WebKit2( pplicationInfo 


unstable since: 4.1 


Description 


struct WebKitApplicationInfo { 
/* No available fields */ 
} 


Information about an application running in automation mode. 


Available since: 4.1 


Constructors 
webkit_application_info_new 
Creates anew WebKitApplicationInfo. 


since: 2.18 


Instance methods 

Get the name of the application. 

since: 2.18 

[webkit_application_info_get_version] 

Get the application version previously set with webkit_application_info_set_version(). 
since: 2.18 

Atomically increments the reference count of info by one. 
since: 2.18 

[webkit_application_info_set_name| 

Set the name of the application. 

since: 2.18 

[webkit_application_info_set_version] 

Set the application version. 

since: 2.18 

Atomically decrements the reference count of info by one. 
since: 2.18 


Content 


° 
e 
@ |Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ApplicationInfo 


Functions 
Generated by[gi-docgen|2023.3 


Function 


since: 2.18 


Declaration 


WebKitApplicationInfo* 
webkit_application_info_new ( 
void 


) 


A pplicationInfonew 


Description 


Creates anew WebKitApplicationInfo. 


Available since: 2.18 


Return value 


Type: |WebKitApplicationInfo 


The newly created WebKitApplicationInfo. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
ApplicationInfo 


Methods 
eet_name}get_version set_namef]set_versionJunre 


Generated by[gi-docgen|2023.3 


Method 
WebKit2A pplicationInfoget_name 
since: 2.18 


Declaration 


const gchar* 

webkit_application_info_get_name ( 
WebKitApplicationInfo* info 

) 


Description 


Get the name of the application. 


If webkit_application_info_set_name() hasn’t been called with a valid name, this 
returns g_get_prgname(). 


Available since: 2.18 
Return value 
Type: const gchar* 


The application name. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

ApplicationInfo 

Methods 
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Method 


since: 2.18 


Declaration 


void 
webkit_application_info_get_version ( 
WebKitApplicationInfo* info, 
guint64* major, 
guint64* minor, 
guint64* micro 


A pplicationInfoget_version 


Description 


Get the application version previously set with webkit_application_info_set_version(). 
Available since: 2.18 

Parameters 

major 


Type: guint 64* 


Return location for the major version number. 


The argument will be set by the function. 


minor 
Type: guint 64* 
Return location for the minor version number. 


The argument will be set by the function. 


The argument can be NULL. 


micro 
Type: guint 64* 
Return location for the micro version number. 


The argument will be set by the function. 


The argument can be NULL. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
ApplicationInfo 


Methods 
eet_name}get_version set_namef]set_versionJunre 


Generated by[gi-docgen|2023.3 
Method 


since: 2.18 


Declaration 


WebKitApplicationInfo* 
webkit_application_info_ref ( 

WebKitApplicationInfo* info 
) 


A pplicationInforef 


Description 


Atomically increments the reference count of info by one. 
This function is MT-safe and may be called from any thread. 


Available since: 2.18 


Return value 


Type: |WebKitApplicationInfo 


The passed in WebKitApplicationInfo. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ApplicationInfo 
Methods 


Generated by[gi-docgen|2023.3 


Method 
WebKit2A pplicationInfoset_name 
since: 2.18 


Declaration 


void 

webkit_application_info_set_name ( 
WebKitApplicationInfo* info, 
const gchar* name 


) 


Description 


Set the name of the application. 

If not provided, or NULL is passed, g_get_prgname () will be used. 
Available since: 2.18 

Parameters 

name 


Type: const gchar* 


The application name. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ApplicationInfo 
Methods 


Generated by[gi-docgen|2023.3 
Method 


since: 2.18 


Declaration 


void 


A pplicationInfoset_version 


webkit_application_info_set_version ( 
WebKitApplicationInfo* info, 
guint64 major, 
guint64 minor, 
guint64 micro 


Description 


Set the application version. 


If the application doesn’t use the format major.minor.micro you can pass 0 as the micro to use 
major.minor, or pass 0 as both micro and minor to use only major number. Any other format must be 
converted to major.minor.micro so that it can be used in version comparisons. 


Available since: 2.18 


Parameters 
major 
Type: guint 64 


The major version number. 


minor 
Type: guint 64 


The minor version number. 


micro 
Type: guint 64 


The micro version number. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
ApplicationInfo 


Methods 
eet_name}get_version set_namef]set_versionJunre 


Generated by[gi-docgen|2023.3 


Method 
WebKit2A pplicationInfounref 
since: 2.18 


Declaration 


void 

webkit_application_info_unref ( 
WebKitApplicationInfo* info 

) 


Description 


Atomically decrements the reference count of info by one. 


If the reference count drops to 0, all memory allocated by the WebKitApplicationInfo is released. 
This function is MT-safe and may be called from any thread. 


Available since: 2.18 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Credential 


Constructors 
new_for_certificatelnew_for_certificate_pin 


Instance methods 


copy|free|get_certificate]get_password]get_persistence]get_username|has_password 
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Struct 


W ebKit2\Credential 


since: 2.2 


Description 


struct WebKitCredential { 
/* No available fields */ 
} 


Groups information used for user authentication. 


Available since: 2.2 


Constructors 


webkit_credential_new 
Create a new credential from the provided username, password and persistence mode. 


since: 2.2 


webkit_credential_new_for_certificate 

Create a new credential from the certificate and persistence mode. 
since: 2.34 

[webkit_credential_new_for_certificate_pin] 


Create a new credential from the provided PIN and persistence mode. 


since: 2.34 


Instance methods 


[webkit_credential_copy| 

Make a copy of the WebKitCredential. 

since: 2.2 

[webkit_credential_free] 

Free the WebKitCredential. 

since: 2.2 

[webkit_credential_get_certificate] 

Get the certificate currently held by this WebKitCredential. 
since: 2.34 

[webkit_credential_get_password] 

Get the password currently held by this WebKitCredential. 
since: 2.2 

Get the persistence mode currently held by this WebKitCredential. 
since: 2.2 

webkit_credential_get_username 


Get the username currently held by this WebKitCredential. 


since: 2.2 
Determine whether this credential has a password stored. 
since: 2.2 


Content 


@ |Description 
@ (Constructors 
e 


Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Credential 


Functions 
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Function 


WebKit3Credentialnew 


since: 2.2 


Declaration 


WebKitCredential* 

webkit_credential_new ( 
const gchar* username, 
const gchar* password, 
WebKitCredentialPersistence persistence 


) 


Description 


Create a new credential from the provided username, password and persistence mode. 
Available since: 2.2 
Parameters 
username 
Type: const gchar* 


The username for the new credential. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


password 
Type: const gchar* 
The password for the new credential. 
The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


persistence 


Type:|(WebKitCredentialPersistence 


The WebKitCredentialPersistence of the new credential. 


Return value 


Type: |WebKitCredential 


A WebKitCredential. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Credential 


Functions 
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Function 


WebKit2Credentialnew_for_certificate 


since: 2.34 


Declaration 


WebKitCredential* 

webkit_credential_new_for_certificate ( 
GTlsCertificate* certificate, 
WebKitCredentialPersistence persistence 


) 


Description 


Create a new credential from the certificate and persistence mode. 


Note that WEBKIT_ CREDENTIAL PERSISTENCE PERMANENT is not supported for 
certificate credentials. 


Available since: 2.34 
Parameters 
certificate 


Type: GTlsCertificate 


The GTlsCertificate, or NULL. 
The argument can be NULL. 


The data is owned by the caller of the function. 


persistence 


Type:\(WebKitCredentialPersistence 


The WebKitCredentialPersistence of the new credential. 


Return value 


Type: |WebKitCredential 


A WebKitCredential. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Credential 


Functions 
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Function 


WebKit2Credentialnew_for_certificate_pin 


since: 2.34 


Declaration 


WebKitCredential* 

webkit_credential_new_for_certificate_pin ( 
const gchar* pin, 
WebKitCredentialPersistence persistence 


) 


Description 


Create a new credential from the provided PIN and persistence mode. 


Note that WEBKIT_CREDENTIAL_PERSISTENCE_PERMANENT is not supported for certificate 
pin credentials. 


Available since: 2.34 
Parameters 
pin 


Type: const gchar* 


The PIN for the new credential. 
The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


persistence 


Type:\(WebKitCredentialPersistence 


The WebKitCredentialPersistence of the new credential. 


Return value 


Type:|WebKitCredential 


A WebKitCredential. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Credential 


Methods 


copy|free]get_certificate 
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Method 


WebKit3Credentialeopy 


since: 2.2 


Declaration 


WebKitCredential* 
webkit_credential_copy ( 

WebKitCredential* credential 
) 


Description 
Make a copy of the WebKitCredential. 


Available since: 2.2 


Return value 


Type: |WebKitCredential 


A copy of passed in WebKitCredential. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Credential 


Methods 


copy|free]get_certificate 
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Method 


WebKit2Credentialfree 


since: 2.2 


Declaration 


void 

webkit_credential_free ( 
WebKitCredential* credential 

) 


Description |[src] 
Free the WebKitCredential. 


Available since: 2.2 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Credential 


Methods 


copy|free]get_certificate 
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Method 


WebKit2Credentialget_certificate 


since: 2.34 


Declaration 


GTlsCertificate* 

webkit_credential_get_certificate ( 
WebKitCredential* credential 

) 


Description 


Get the certificate currently held by this WebKitCredential. 


Available since: 2.34 


Return value 
Type: GTlsCertificate 


A GTlsCertificate, or NULL. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Credential 


Methods 


copy|free]get_certificate 
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Method 
WebKit2Credentialget_password 
WebKit2 p 

since: 2.2 


Declaration 


const gchar* 
webkit_credential_get_password ( 
WebKitCredential* credential 


) 


Description 

Get the password currently held by this WebKitCredential. 
Available since: 2.2 

Return value 

Type: const gchar* 

The password stored in the WebKitCredential. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Credential 


Methods 
copy}free[get_certificate 
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Method 
WebKitCredentialget_persistence 
since: 2.2 


Declaration 


WebKitCredentialPersistence 

webkit_credential_get_persistence ( 
WebKitCredential* credential 

) 


Description 
Get the persistence mode currently held by this WebKitCredential. 


Available since: 2.2 


Return value 


Type: |WebKitCredentialPersistence 


The WebKitCredentialPersistence stored in the WebKitCredential. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Credential 


Methods 


copy|free]get_certificate 
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Method 
WebKitCredentialget_username 
since: 2.2 


Declaration 


const gchar* 

webkit_credential_get_username ( 
WebKitCredential* credential 

) 


Description 

Get the username currently held by this WebKitCredential. 
Available since: 2.2 

Return value 

Type: const gchar* 

The username stored in the WebKitCredential. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Credential 


Methods 
copy}free[get_certificate 
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Method 
WebKit2Credentialhas_password 
since: 2.2 


Declaration 


gboolean 

webkit_credential_has_password ( 
WebKitCredential* credential 

) 


Description 

Determine whether this credential has a password stored. 
Available since: 2.2 

Return value 

Type: gboolean 


TRUE if the credential has a password or FALSE otherwise. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Instance methods 


set_default_value]get_details|get_identifier 


Generated by[gi-docgen|2023.3 
Struct 


WebKit2Feature 


since: 2.42 


Description 


struct WebKitFeature { 
/* No available fields */ 
} 


Describes a web engine feature that may be toggled at runtime. 


The WebKit web engine includes a set of features which may be toggled programmatically, each one 
represented by aWebKitFeature that provides information about it: 


@ A unique aidentifiera:|webkit_feature_get_identit 

@ A adefault valued, which indicates whether the option is enabled automatically: 
webkit_feature_get_default_value() 

@ Its dstatusa, which determines whether it should be considered user-settable and its development 
stage (see[WebKitFeaturest at us]for details): 

@ Acategory, which may be used to group features together: 
webkit_feature_get_category () 


@ An optional short 4namea which can be presented to an user:|webkit_feature_get_name () 
@ An optional longer adetaileda description:|webkit_feature_get_details() 


The lists of available features can be obtained withwebkit_settings_get_all_features () 


webkit_settings_get_experimental_features ()}| and 
webkit_settings_get_development_features ()). As arule of thumb, applications which 
may want to allow users (i.e. web developers) to test WebKit features should use the list of experimental 
features. Additionally, applications might want to expose development features when targeting technically 
inclined users for early testing of in-development features (i.e. in 4technology previewa or 

Acanarya builds). 


Applications must not expose the list of all features to end users because they often lack descriptions and 
control parts of the web engine which are either intended to be used during development of WebKit itself, 
or in specific scenarios to tweak how WebKit integrates with the application. 


Available since: 2.42 


Instance methods 
webkit_feature_get_category 


Gets the category of the feature. 

since: 2.42 

Gets whether the feature is enabled by default. 
since: 2.42 


webkit_feature_get_details 


Gets a description for the feature. 


since: 2.42 

[webkit_feature_get_identifier] 

Gets a string that uniquely identifies the feature. 
since: 2.42 

[webkit_feature_get_name| 

Gets a short name for the feature. 


since: 2.42 


webkit_feature_get_status 


Gets the status of the feature. 

since: 2.42 

Atomically acquires a reference on the given feature. 
since: 2.42 

Atomically releases a reference on the given feature. 
since: 2.42 


Content 


° 
@ (Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Instance methods 
get] 
Generated by 2023.3 


Struct 


WebKit2FeatureList 


since: 2.42 


Description 


struct WebKitFeatureList { 
/* No available fields */ 
} 


Contains a set of toggle-able web engine features. 


The list supports passing around a set ofWebKitFeature|objects and iterating over them: 


g_autoptr(WebKitFeatureList) list = webkit_settings_get_experimental_features(); 
for (gsize i= 0; i < webkit_feature_list_get_length(list): i++) { 

WebKitFeature *feature = webkit_feature_list_get (list, i); 

// Do something with "feature". 


} 


Lists of features can be obtained with|webkit_settings_get_experimental_features () 


webkit_settings_get_development_features ()} and 
webkit_settings_get_all_ features () 


Available since: 2.42 


Instance methods 

Gets a feature given its index. 

since: 2.42 

webkit_feature_list_get_length 

Gets the number of elements in the feature list. 

unstable since: 4.1 

Atomically acquires a reference on the given feature_list. 
since: 2.42 

Atomically releases a reference on the given feature_list. 


since: 2.42 


Content 


° 
@ |Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

Methods 

get 
Generated by[gi-docgen|2023.3 


Method 


WebKit2F eatureListget 


since: 2.42 


Declaration 


WebKitFeature* 

webkit_feature_list_get ( 
WebKitFeatureList* feature_list, 
gsize index 


) 


Description 


Gets a feature given its index. 
Available since: 2.42 
Parameters 
index 

Type: gsize 


Index of the feature. 


Return value 


Type: |WebKitFeature 


The feature at index. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

Methods 

get] 
Generated by 2023.3 


Method 
WebKit2FeatureListget_length 
since: 2.42 


Declaration 


gsize 
webkit_feature_list_get_length ( 
WebKitFeatureList* feature_list 


) 


Description 


Gets the number of elements in the feature list. 
Available since: 2.42 

Return value 

Type: gsize 

Number of elements. 


Since 2.42 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 
get 
Generated by 2023.3 


Method 


WebKit2FeatureListref 


since: 2.42 


Declaration 


WebKitFeatureList* 
webkit_feature_list_ref ( 
WebKitFeatureList* feature_list 


) 


Description 


Atomically acquires a reference on the given feature_list. 
This function is MT-safe and may be called from any thread. 


Available since: 2.42 


Return value 


Type: |WebKitFeatureList 


The same feature_list with an additional reference. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Methods 
get 
Generated by 2023.3 


Method 
WebKit2FeatureListunref 
since: 2.42 


Declaration 


void 
webkit_feature_list_unref ( 
WebKitFeatureList* feature_list 


) 


Description 


Atomically releases a reference on the given feature_list. 


If the reference was the last, the resources associated to the feature_list are freed. This function is 
MT-safe and may be called from any thread. 


Available since: 2.42 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Constructors 


new 


Instance methods 


copyfree|set_altitude|set_altitude_accurac 
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Struct 


W ebKit2GeolocationPosition 


since: 2.26 


Description 


struct WebKitGeolocationPosition { 
/* No available fields */ 
} 


An opaque struct to provide position updates to a WebKitGeolocationManager. 


WebKitGeolocationPosition is an opaque struct used to provide position updates to a 
WebKitGeolocationManager using webkit_geolocation_manager_update_position(). 


Available since: 2.26 


Constructors 


webkit_geolocation_position_new 


Create anew WebKitGeolocationPosition. 


since: 2.26 


Instance methods 


webkit_geolocation_position_copy 


Make a copy of the WebKitGeolocationPosition. 
since: 2.26 

lwebkit_geolocation_position_free] 

Free the WebKitGeolocationPosition. 

since: 2.26 

Set the position altitude. 


since: 2.26 


webkit_geolocation_position_set_altitude_accuracy 


Set the accuracy of position altitude. 
since: 2.26 

Set the position heading. 

since: 2.26 

Set the position speed. 

since: 2.26 


webkit_geolocation_position_set_timestamp 


Set the position timestamp. 


since: 2.26 


Content 


@ |Description 
@ (Constructors 
e 


Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Functions 


Generated by[gi-docgen|2023.3 


Function 
WebKit2GeolocationPositionnew 
since: 2.26 


Declaration 


WebKitGeolocationPosition* 
webkit_geolocation_position_new ( 
double latitude, 
double longitude, 
double accuracy 


) 


Description 


Create anew WebKitGeolocationPosition. 
Available since: 2.26 
Parameters 
latitude 
Type: double 


A valid latitude in degrees. 


longitude 
Type: double 


A valid longitude in degrees. 


accuracy 
Type: double 


Accuracy of location in meters. 


Return value 


Type: |WebKitGeolocationPosition 


A newly created WebKitGeolocationPosition. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
copy|free|set_altitude}set_altitude_accurac 
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Method 
WebKit2GeolocationPositioncopy 
since: 2.26 


Declaration 


WebKitGeolocationPosition* 
webkit_geolocation_position_copy ( 
WebKitGeolocationPosition* position 


) 


Description 


Make a copy of the WebKitGeolocationPosition. 


Available since: 2.26 


Return value 


Type: |WebKitGeolocationPosition 


A copy of position. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


copy|free}set_altitudefset_altitude_accurac 
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Method 


WebKit2GeolocationPositionfree 


since: 2.26 


Declaration 


void 
webkit_geolocation_position_free ( 
WebKitGeolocationPosition* position 


) 


Description 


Free the WebKitGeolocationPosition. 


Available since: 2.26 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
copy|free|set_altitude}set_altitude_accurac 
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Method 


WebKit2GeolocationPositionset_altitude 


since: 2.26 


Declaration 


void 

webkit_geolocation_position_set_altitude ( 
WebKitGeolocationPosition* position, 
double altitude 

) 


Description 


Set the position altitude. 
Available since: 2.26 
Parameters 
altitude 

Type: double 


Altitude in meters. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
copy|free|set_altitude}set_altitude_accurac 
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Method 


WebKit J eolocationPositionset_altitude_accuracy 


since: 2.26 


Declaration 


void 
webkit_geolocation_position_set_altitude_accuracy ( 
WebKitGeolocationPosition* position, 
double altitude_accuracy 
) 


Description 


Set the accuracy of position altitude. 
Available since: 2.26 
Parameters 
altitude_accuracy 

Type: double 


Accuracy of position altitude in meters. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

GeolocationPosition 

Methods 

copy|free}set_altitude}set_altitude_accurac 
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Method 


WebKit2GeolocationPositionset_heading 


since: 2.26 


Declaration 


void 

webkit_geolocation_position_set_heading ( 
WebKitGeolocationPosition* position, 
double heading 

) 


Description 


Set the position heading. 


Set the position heading, as a positive angle between the direction of movement and the North 
direction, in clockwise direction. 


Available since: 2.26 


Parameters 


heading 


Type: double 


Heading in degrees. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
copy|free|set_altitude}set_altitude_accurac 
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Method 


WebKit2GeolocationPositionset_speed 


since: 2.26 


Declaration 


void 

webkit_geolocation_position_set_speed ( 
WebKitGeolocationPosition* position, 
double speed 

) 


Description 


Set the position speed. 
Available since: 2.26 
Parameters 
speed 

Type: double 


Speed in meters per second. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

GeolocationPosition 

Methods 

copy|free}set_altitude}set_altitude_accurac 


Generated by[gi-docgen]2023.3 
Method 


WebKit2GeolocationPositionset_timestamp 


since: 2.26 


Declaration 


void 

webkit_geolocation_position_set_timestamp ( 
WebKitGeolocationPosition* position, 
guint64 timestamp 


) 


Description 


Set the position timestamp. 
By default it’s the time when the position was created. 


Available since: 2.26 


Parameters 
timestamp 


Type: guint 64 


Timestamp in seconds since the epoch, or 0 to use current time. 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodUnderline 


Constructors 


5 


ew) 


Instance methods 


copy}free|set_color 
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Struct 


WebKit2InputMethod Underline 


since: 2.28 


Description 


struct WebKitInputMethodUnderline { 
/* No available fields */ 
} 


Range of text in an preedit string to be shown underlined. 


Available since: 2.28 


Constructors 


webkit_input_method_underline_new 


Create anew WebKit InputMethodUnderline for the given range in preedit string. 


since: 2.28 


Instance methods 

Make a copy of the WebKit InputMethodUnderline. 
since: 2.28 

Free the WebKit InputMethodUnderline. 

since: 2.28 

Set the color of the underline. 

since: 2.28 


Content 


@ |Description 
@ (Constructors 
e 


Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
InputMethodUnderline 


Functions 
Generated by[gi-docgen|2023.3 


Function 


WebKit2InputMethodUnderlinenew 


since: 2.28 


Declaration 


WebKit InputMethodUnderline* 
webkit_input_method_underline_new ( 
guint start_offset, 
guint end_offset 
) 


Description 


Create anew WebKit InputMethodUnderline for the given range in preedit string. 
Available since: 2.28 
Parameters 
start_offset 
Type: guint 


The start offset in preedit string. 


end_offset 
Type: guint 


The end offset in preedit string. 


Return value 


Type: |WebKitInputMethodUnderline 


A newly created WebKit InputMethodUnderline. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Methods 
copy|free]set_color| 
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Method 
WebKit2InputMethodUnderlinecopy 
since: 2.28 


Declaration 


WebKit InputMethodUnderline* 
webkit_input_method_underline_copy ( 

WebKitInputMethodUnderline* underline 
) 


Description 


Make a copy of the WebKit InputMethodUnderline. 


Available since: 2.28 


Return value 


Type: |WebKitInputMethodUnderline 


A copy of passed in WebKit InputMethodUnderline. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 
InputMethodUnderline 


Methods 
copy|free]set_color| 
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Method 


WebKit2ImputMethodUnderlinefree 


since: 2.28 


Declaration 


void 

webkit_input_method_underline_free ( 
WebKit InputMethodUnderline* underline 

) 


Description 


Free the WebKit InputMethodUnderline. 


Available since: 2.28 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Methods 
copy|free]set_color| 
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Method 


WebKit2InputMethodUnderlineset_color 


since: 2.28 


Declaration 


void 

webkit_input_method_underline_set_color ( 
WebKit InputMethodUnderline* underline, 
const GdkRGBA* rgba 

) 


Description 


Set the color of the underline. 

If rgba is NULL the foreground text color will be used for the underline too. 
Available since: 2.28 

Parameters 

rgba 


Type: GAKRGBA 


A GdkRGBA or NULL. 


The argument can be NULL. 


The data is owned by the caller of the method. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ITPFirstPart 


Instance methods 


gset_last_update_time]get_website_data_access_allowed 
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Struct 


WebKit2ITPFirstParty 


since: 2.30 


Description 


struct WebKitITPFirstParty { 
/* No available fields */ 
} 


Describes a first party origin. 


Available since: 2.30 


Instance methods 


webkit_itp_first_party_get_domain 


Get the domain name of itp_first_party. 


since: 2.30 


webkit_itp_first_party_get_last_update_time 


Get the last time aWebKit ITPThirdParty has been seen under itp_first_party. 


since: 2.30 


webkit_itp_first_party_get_website_data_access_allowed 


Get whether itp_first_party has granted website data access to its WebKit ITPThirdParty. 
since: 2.30 

[webkit_itp_first_party_ref] 

Atomically increments the reference count of itp_first_party by one. 

since: 2.30 

Atomically decrements the reference count of itp_first_party by one. 

since: 2.30 


Content 


° 
@ |Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ITPFirstPart 


Methods 


gset_last_update_time]get_website_data_access_allowed 
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Method 


WebKit2I[TPFirstPartyget_domain 


since: 2.30 


Declaration 


const char* 
webkit_itp_first_party_get_domain ( 

WebKitITPFirstParty* itp_first_party 
) 


Description 


Get the domain name of itp_first_party. 
Available since: 2.30 

Return value 

Type: const char* 

The domain name. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

ITPFirstPart 

Methods 

get_website_data_access_allowed 
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Method 


WebKit | TPFirstPartyget_last_update_time 


since: 2.30 


Declaration 


GDateTime* 

webkit_itp_first_party_get_last_update_time ( 
WebKitITPFirstParty* itp_first_party 

) 


Description 


Get the last time aWebKit ITPThirdParty has been seen under itp_first_party. 


Each WebKit ITPFirstParty is created by 
webkit_itp_third_party_get_first_parties () and therefore corresponds to exactly one 
WebKit ITPThirdParty. 


Available since: 2.30 


Return value 


Type: GDateTime 


The last update time as a GDateTime. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

ITPFirstPart 

Methods 

get_website_data_access_allowed 


Generated by[gi-docgen|2023.3 
Method 


WebKit | TPFirstPartyget_website_data_access_allowed 


since: 2.30 


Declaration 


gboolean 

webkit_itp_first_party_get_website_data_access_allowed ( 
WebKitITPFirstParty* itp_first_party 

) 


Description 


Get whether itp_first_party has granted website data access to its WebKit ITPThirdParty. 


Each WebKit ITPFirstParty is created by 
webkit_itp_third_party_get_first_parties () and therefore corresponds to exactly one 
WebKit ITPThirdParty. 


Available since: 2.30 


Return value 


Type: gboolean 


TRUE if website data access has been granted, or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ITPFirstPart 


Methods 


gset_last_update_time]get_website_data_access_allowed 
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Method 


WebKit2ITPFirstPartyref 


since: 2.30 


Declaration 


WebKitITPFirstParty* 
webkit_itp_first_party_ref ( 

WebKitITPFirstParty* itp_first_party 
) 


Description 


Atomically increments the reference count of itp_first_party by one. 
This function is MT-safe and may be called from any thread. 


Available since: 2.30 


Return value 


Type: |WebKitITPFirstParty 


The passed WebKit ITPFirstParty. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ITPFirstPart 


Methods 


gset_last_update_time]get_website_data_access_allowed 
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Method 
WebKit2I[TPFirstPartyunref 
since: 2.30 


Declaration 


void 

webkit_itp_first_party_unref ( 
WebKitITPFirstParty* itp_first_party 

) 


Description 


Atomically decrements the reference count of itp_first_party by one. 


If the reference count drops to 0, all memory allocated by WebKit ITPFirstParty is released. This 
function is MT-safe and may be called from any thread. 


Available since: 2.30 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ITPThirdPart 


Instance methods 


get_first_parties 
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Struct 


WebKit2ITPThirdParty 


since: 2.30 


Description 


struct WebKitITPThirdParty { 
/* No available fields */ 
} 


Describes a third party origin. 


Available since: 2.30 


Instance methods 
webkit_itp_third_party_get_domain 
Get the domain name of itp_third_party. 


since: 2.30 


Get the list of WebKitITPFirstParty under which itp_third_party has been seen. 
since: 2.30 

[webkit_itp_third_party_ref] 

Atomically increments the reference count of itp_third_party by one. 

since: 2.30 

Atomically decrements the reference count of itp_third_party by one. 

since: 2.30 


Content 


° 
@ (Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ITPThirdPart 
Methods 


Generated by[gi-docgen|2023.3 
Method 


WebKit2[TPThirdPartyget_domain 


since: 2.30 


Declaration 


const char* 
webkit_itp_third_party_get_domain ( 

WebKitITPThirdParty* itp_third_party 
) 


Description 


Get the domain name of itp_third_party. 
Available since: 2.30 

Return value 

Type: const char* 

The domain name. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ITPThirdPart 
Methods 


Generated by[gi-docgen|2023.3 
Method 


WebKit2[TPThirdPartyget_first_parties 


since: 2.30 


Declaration 


GList* 

webkit_itp_third_party_get_first_parties ( 
WebKitITPThirdParty* itp_third_party 

) 


Description 


Get the list of WebKitITPFirstParty under which itp_third_party has been seen. 
Available since: 2.30 

Return value 

Type: A list of WebKitITPFirstParty* 


AGList of WebKitITPFirstParty. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ITPThirdPart 
Methods 
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Method 


WebKit@ITPThirdPartyref 


since: 2.30 


Declaration 


WebKitITPThirdParty* 
webkit_itp_third_party_ref ( 

WebKitITPThirdParty* itp_third_party 
) 


Description 


Atomically increments the reference count of itp_third_party by one. 
This function is MT-safe and may be called from any thread. 


Available since: 2.30 


Return value 


Type: |WebKitITPThirdParty 


The passed WebKit ITPThirdParty. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
ITPThirdPart 
Methods 


Generated by[gi-docgen|2023.3 


Method 
WebKit@ITPThirdPartyunref 
since: 2.30 


Declaration 


void 

webkit_itp_third_party_unref ( 
WebKitITPThirdParty* itp_third_party 

) 


Description 


Atomically decrements the reference count of itp_third_party by one. 


If the reference count drops to 0, all memory allocated by WebKit ITPThirdParty is released. This 
function is MT-safe and may be called from any thread. 


Available since: 2.30 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


JavascriptResult! 


Instance methods 
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Struct 


WebKit2JavascriptResult 


unstable since: 4.1 


Description 


struct WebKitJavascriptResult { 
/* No available fields */ 
} 


Result of JavaScript evaluation in a web view. 


Available since: 4.1 


Instance methods 


webkit_javascript_result_get_global_context 


Get the global Javascript context. 


unstable deprecated: 2.22 since: 4.1 


webkit_javascript_result_get_js_value 

Get the JSCValue of js_result. 

since: 2.22 

[webkit_javascript_result_get_value| 

Get the value of js_result. 

unstable deprecated: 2.22 since: 4.1 

Atomically increments the reference count of js_result by one. 
unstable since: 4.1 

Atomically decrements the reference count of js_result by one. 


unstable since: 4.1 


Content 


° 
@ |Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


JavascriptResult! 


Methods 


Generated by[gi-docgen|2023.3 


Method 


WebKit J avascriptResultget_global_context 


deprecated: 2.22 


Declaration 


JSGlobalContextRef 

webkit_javascript_result_get_global_context ( 
WebKitJavascriptResult* js_result 

) 


Description 


Get the global Javascript context. 


Get the global Javascript context that should be used with the JSValueRef returned 
by webkit_javascript_result_get_value(). 


Deprecated since: 2.22 


Use jsc_value_get_context () instead. 


This method is not directly available to language bindings. 


Return value 
Type: TSGlobalContextRef 


The JSGlobalContextRef for the WebKitJavascriptResult. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


JavascriptResult! 


Methods 
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Method 
WebKit2JavascriptResultget_js_value 
since: 2.22 


Declaration 


JSCValue* 

webkit_javascript_result_get_js_value ( 
WebKitJavascriptResult* js_result 

) 


Description 


Get the JSCValue of js_result. 
Available since: 2.22 

Return value 

Type: TSCValue 


The JSCValue of the WebKitJavascriptResult. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


JavascriptResult! 


Methods 
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Method 


WebKit J avascriptResultget_value 


deprecated: 2.22 


Declaration 


JSValueRef 

webkit_javascript_result_get_value ( 
WebKitJavascriptResult* js_result 

) 


Description 


Get the value of js_result. 


You should use the JSGlobalContextRef returned by 
webkit_javascript_result_get_global_context () to use the JSValueRef. 


Deprecated since: 2.22 
Use webkit_javascript_result_get_js_value() instead. 


This method is not directly available to language bindings. 


Return value 
Type: TSValueRef 


The JSValueRef of the WebKitJavascriptResult. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


JavascriptResult! 


Methods 
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Method 


WebKit2JavascriptResultref 
Declaration 


WebKitJavascriptResult* 
webkit_javascript_result_ref ( 

WebKitJavascriptResult* js_result 
) 


Description 


Atomically increments the reference count of js_result by one. 


This function is MT-safe and may be called from any thread. 


Return value 


Type: |WebKitJavascriptResult 


The passed in WebKitJavascriptResult. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


JavascriptResult! 


Methods 
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Method 


WebKit2JavascriptResultunref 
Declaration 


void 
webkit_javascript_result_unref ( 

WebKitJavascriptResult* js_result 
) 


Description 


Atomically decrements the reference count of js_result by one. 


If the reference count drops to 0, all memory allocated by the WebKitJavascriptResult is released. 
This function is MT-safe and may be called from any thread. 


| 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
MemoryPressureSettings 


Constructors 


Instance methods 


copy|free|get_conservative_threshold|get_kill_threshold get_poll_interval 
get_strict_threshold]set_conservative_threshold]set_kill_ threshold set_poll_interval 
set_strict_threshold 


Generated by 2023.3 
Struct 


WebKit2MemoryPressureSettings 


since: 2.34 


Description 


struct WebKitMemoryPressureSettings { 
/* No available fields */ 
} 


A boxed type representing the settings for the memory pressure handler 


WebKitMemoryPressureSettings is a boxed type that can be used to provide some custom 
settings to control how the memory pressure situations are handled by the different processes. 


The memory pressure system implemented inside the different process will try to keep the memory usage 
under the defined memory limit. In order to do that, it will check the used memory with a user defined 
frequency and decide whether it should try to release memory. The thresholds passed will define how 
urgent is to release that memory. 


Take into account that badly defined parameters can greatly reduce the performance of the engine. For 
example, setting memory limit too low with a fast poll interval can cause the process to constantly be 
trying to release memory. 


A WebKitMemoryPressureSettings can be passed to a WebKitWebContext constructor, and 
the settings will be applied to all the web processes created by that context. 


A WebKitMemoryPressureSettings can be passed to 
webkit_website_data_manager_set_memory_pressure_settings(), and the settings will be applied to all the 
network processes created after that call by any instance of WebKitWebsiteDataManager. 


Available since: 2.34 


Constructors 


webkit_memory_pressure_settings_new 


Create anew WebKitMemoryPressureSettings with the default values. 


since: 2.34 


Instance methods 


webkit_memory_pressure_settings_copy 


Make a copy of settings. 
since: 2.34 
Free the WebKitMemoryPressureSettings. 


since: 2.34 


webkit_memory_pressure_settings_get_conservative_threshold 


Gets the conservative memory usage threshold. 


since: 2.34 


webkit_memory_pressure_settings_get_kill_threshold 


Gets the kill memory usage threshold. 


since: 2.34 


webkit_memory_pressure_settings_get_memory_limit 


Gets the memory usage limit. 


since: 2.34 


webkit_memory_pressure_settings_get_poll_interval 


Gets the interval at which memory usage is checked. 


since: 2.34 


webkit_memory_pressure_settings_get_strict_threshold 


Gets the strict memory usage threshold. 


since: 2.34 


webkit_memory_pressure_settings_set_conservative_threshold 


Sets the memory limit for the conservative policy to start working. 
since: 2.34 
Sets value as the fraction of the defined memory limit where the process will be killed. 


since: 2.34 


webkit_memory_pressure_settings_set_memory_limit 


Sets memory_limit the memory limit value to settings. 


since: 2.34 


webkit_memory_pressure_settings_set_poll_interval 


Sets value as the poll interval used by settings. 
since: 2.34 
Sets the memory limit for the strict policy to start working. 


since: 2.34 


Content 


@ |Description 
@ (Constructors 
e 


Methods 


| 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
MemoryPressureSettings 


Functions 
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Function 
WebKit2MemoryPressureSettingsnew 
since: 2.34 


Declaration 


WebKitMemoryPressureSettings* 
webkit_memory_pressure_settings_new ( 
void 


) 


Description 


Create anew WebKitMemoryPressureSettings with the default values. 


Available since: 2.34 


Return value 


Type: |WebKitMemoryPressureSettings 


A new WebKitMemoryPressureSettings instance filled with the default values. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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API Version: 4.1 


Library Version: 2.42.4 
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Method 
WebKit2MemoryPressureSettingscopy 
since: 2.34 


Declaration 


WebKitMemoryPressureSettings* 
webkit_memory_pressure_settings_copy ( 
WebKitMemoryPressureSettings* settings 


) 


Description 


Make a copy of settings. 


Available since: 2.34 


Return value 


Type: |WebKitMemoryPressureSettings 


A copy of of the passed WebKitMemoryPressureSettings. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
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Method 


WebKit2MemoryPressureSettingsfree 


since: 2.34 


Declaration 


void 
webkit_memory_pressure_settings_free ( 

WebKitMemoryPressureSettings* settings 
) 


Description 


Free the WebKitMemoryPressureSettings. 


Available since: 2.34 


| 


WebKit2 
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Library Version: 2.42.4 
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Method 
WebKit2MemoryPressureSettingspet_conservative_threshold 
since: 2.34 


Declaration 


gdouble 
webkit_memory_pressure_settings_get_conservative_threshold ( 
WebKitMemoryPressureSettings* settings 


) 


Description 


Gets the conservative memory usage threshold. 
Available since: 2.34 

Return value 

Type: gdouble 


Value in the (0, 1) range. 


| 
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Library Version: 2.42.4 
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Method 


WebKit2MemoryPressureSettingsget_kill_threshold 


since: 2.34 


Declaration 


gdouble 

webkit_memory_pressure_settings_get_kill_threshold ( 
WebKitMemoryPressureSettings* settings 

) 


Description 


Gets the kill memory usage threshold. 
Available since: 2.34 

Return value 

Type: gdouble 


Positive value, can be zero. 
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Method 
WebKit2MemoryPressureSettingsget_memory_limit 
since: 2.34 


Declaration 


guint 

webkit_memory_pressure_settings_get_memory_limit ( 
WebKitMemoryPressureSettings* settings 

) 


Description 


Gets the memory usage limit. 
Available since: 2.34 
Return value 

Type: guint 


Current value, in megabytes. 
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Method 
WebKit2MemoryPressureSettingsget_poll_interval 
since: 2.34 


Declaration 


gdouble 
webkit_memory_pressure_settings_get_poll_interval ( 
WebKitMemoryPressureSettings* settings 


) 


Description 


Gets the interval at which memory usage is checked. 
Available since: 2.34 

Return value 

Type: gdouble 


Current interval value, in seconds. 


| 
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Methods 
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Method 
WebKit2MemoryPressureSettingsget_strict_threshold 
since: 2.34 


Declaration 


gdouble 

webkit_memory_pressure_settings_get_strict_threshold ( 
WebKitMemoryPressureSettings* settings 

) 


Description 


Gets the strict memory usage threshold. 
Available since: 2.34 

Return value 

Type: gdouble 


Value in the (0, 1) range. 


| 
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Method 
WebKit2MemoryPressureSettingsset_conservative_threshold 
since: 2.34 


Declaration 


void 
webkit_memory_pressure_settings_set_conservative_threshold ( 
WebKitMemoryPressureSettings* settings, 
gdouble value 
) 


Description 


Sets the memory limit for the conservative policy to start working. 


Sets value as the fraction of the defined memory limit where the conservative policy starts working. This 
policy will try to reduce the memory footprint by releasing non critical memory. 


The threshold must be bigger than 0 and smaller than 1, and it must be smaller than the strict threshold 
defined in settings. The default value is 0.33. 


Available since: 2.34 


Parameters 
value 
Type: gdouble 


Fraction of the memory limit where the conservative policy starts working. 
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Method 
WebKit2MemoryPressureSettingsset_kill_threshold 
since: 2.34 


Declaration 


void 
webkit_memory_pressure_settings_set_kill_threshold ( 
WebKitMemoryPressureSettings* settings, 
gdouble value 
) 


Description 


Sets value as the fraction of the defined memory limit where the process will be killed. 


The threshold must be a value bigger or equal to 0. A value of 0 means that the process is never killed. If 


the threshold is not 0, then it must be bigger than the strict threshold defined in sett ings. The threshold 


can also have values bigger than 1. The default value is 0. 


Available since: 2.34 


Parameters 
value 
Type: gdouble 


Fraction of the memory limit where the process will be killed because of excessive memory usage. 
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Method 
WebKit2MemoryPressureSettingsset_memory_limit 
since: 2.34 


Declaration 


void 
webkit_memory_pressure_settings_set_memory_limit ( 
WebKitMemoryPressureSettings* settings, 
guint memory_limit 


) 


Description |[src] 
Sets memory_limit the memory limit value to settings. 


The default value is the system’s RAM size with a maximum of 3GB. 


Available since: 2.34 


Parameters 
memory_limit 
Type: guint 


Amount of memory (in MB) that the process is allowed to use. 
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Methods 
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Method 
WebKit2MemoryPressureSettingsset_poll_interval 
since: 2.34 


Declaration 


void 
webkit_memory_pressure_settings_set_poll_interval ( 
WebKitMemoryPressureSettings* settings, 
gdouble value 
) 


Description |[src] 
Sets value as the poll interval used by settings. 


The poll interval value must be bigger than 0. The default value is 30 seconds. 


Available since: 2.34 


Parameters 
value 
Type: gdouble 


Period (in seconds) between memory usage measurements. 


| 


WebKit2 
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Method 
WebKit2MemoryPressureSettingsset_strict_threshold 
since: 2.34 


Declaration 


void 
webkit_memory_pressure_settings_set_strict_threshold ( 
WebKitMemoryPressureSettings* settings, 
gdouble value 
) 


Description 


Sets the memory limit for the strict policy to start working. 


Sets value as the fraction of the defined memory limit where the strict policy starts working. This policy 


will try to reduce the memory footprint by releasing critical memory. 


The threshold must be bigger than 0 and smaller than 1. Also, it must be bigger than the conservative 


threshold defined in settings, and smaller than the kill threshold if the latter is not 0. The default value 


is 0.5. 


Available since: 2.34 
Parameters 
value 

Type: gdouble 


Fraction of the memory limit where the strict policy starts working. 


| 
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API Version: 4.1 
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Struct 


WebKit2MimelInfo 


unstable since: 4.1 


Description 


struct WebKitMimeInfo { 
/* No available fields */ 
} 


Information about a MIME type. 


Available since: 4.1 


Instance methods 


Gets the description of the MIME type. 


unstable deprecated: 2.32 since: 4.1 


webkit_mime_info_get_extensions 


Get the list of file extensions associated to the MIME type. 
unstable deprecated: 2.32 since: 4.1 
webkit_mime_info_get_mime_type 

Gets the MIME type. 

unstable deprecated: 2.32 since: 4.1 

Atomically increments the reference count of info by one. 
unstable deprecated: 2.32 since: 4.1 

Atomically decrements the reference count of info by one. 
unstable deprecated: 2.32 since: 4.1 


Content 


: 
@ (Methods 
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Method 


WebKit2MimelInfoget_description 


deprecated: 2.32 


Declaration 


const gchar* 

webkit_mime_info_get_description ( 
WebKitMimeInfo* info 

) 


Description 


Gets the description of the MIME type. 
Deprecated since: 2.32 

Please do not use it in newly written code. 
Return value 

Type: const gchar* 


Description, as a string. 


The data is owned by the instance. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 


WebKit2Mimelnfoget_extensions 


deprecated: 2.32 


Declaration 


const gchar* const* 

webkit_mime_info_get_extensions ( 
WebKitMimeInfo* info 

) 


Description 


Get the list of file extensions associated to the MIME type. 
Deprecated since: 2.32 

Please do not use it in newly written code. 

Return value 

Type: An array of ut £8 


A NULL-terminated array of strings. 


The array is NULL-terminated. 
The data is owned by the instance. 


Each element is a NUL terminated UTF-8 string. 
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Library Version: 2.42.4 
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Method 


WebKit2MimelInfoget_mime_type 


deprecated: 2.32 


Declaration 


const gchar* 

webkit_mime_info_get_mime_type ( 
WebKitMimeInfo* info 

) 


Description 


Gets the MIME type. 

Deprecated since: 2.32 

Please do not use it in newly written code. 
Return value 

Type: const gchar* 


MIME type, as a string. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
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Method 


WebKit2Mimelnforet 


deprecated: 2.32 


Declaration 


WebKitMimeInfo* 
webkit_mime_info_ref ( 

WebKitMimeInfo* info 
) 


Description 


Atomically increments the reference count of info by one. 
This function is MT-safe and may be called from any thread. 
Deprecated since: 2.32 


Please do not use it in newly written code. 


Return value 


Type: 


The passed in WebKitMimeInfo. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
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Method 


WebKit2Mimelnfounref 


deprecated: 2.32 


Declaration 


void 


webkit_mime_info_unref ( 
WebKitMimeInfo* info 
) 


Description 


Atomically decrements the reference count of info by one. 


If the reference count drops to 0, all memory allocated by the WebKitMimeInfo is released. This 
function is MT-safe and may be called from any thread. 


Deprecated since: 2.32 


Please do not use it in newly written code. 
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Struct 


WebKit2NavigationAction 


unstable since: 4.1 


Description 


struct WebKitNavigationAction { 
/* No available fields */ 
} 


Provides details about interaction resulting in a resource load. 


Available since: 4.1 


Instance methods 
webkit_navigation_action_copy 
Make a copy of navigation. 


since: 2.6 


webkit_navigation_action_free 


Free the WebKitNavigationAction. 
since: 2.6 


webkit_navigation_action_get_frame_name 


Gets the navigation target frame name. For example if navigation was triggered by clicking a link 
with a target attribute equal to “_blank”’, this will return the value of that attribute. In all other cases this 
function will return NULL. 


since: 2.40 

lwebkit_navigation_action_get_modifiers] 

Return the modifier keys. 

since: 2.6 

[webkit_navigation_action_get_mouse_button| 

Return the number of the mouse button that triggered the navigation. 


since: 2.6 


webkit_navigation_action_get_navigation_type 


Return the type of action that triggered the navigation. 
since: 2.6 
Return the WebKitURIRequest associated with the navigation action. 


since: 2.6 


webkit_navigation_action_is_redirect 


Returns whether the navigation was redirected. 


since: 2.20 


webkit_navigation_action_is_user_gesture 


Return whether the navigation was triggered by a user gesture like a mouse click. 


since: 2.6 


Content 


: 
@ |Methods 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Methods 


copy|free|get_frame_name]get_modifiers]get_mouse_button]get_navigation_type|get_request|is redirect 
is_user_gesture 


Generated by[gi-docgen]2023.3 


Method 
WebKit2NavigationActioncopy 
since: 2.6 


Declaration 


WebKitNavigationAction* 
webkit_navigation_action_copy ( 
WebKitNavigationAction* navigation 


) 


Description 


Make a copy of navigation. 


Available since: 2.6 


Return value 


Type: |WebKitNavigationAction 


A copy of passed in WebKitNavigationAction. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
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Method 


WebKit2NavigationActionfree 


since: 2.6 


Declaration 


void 
webkit_navigation_action_free ( 
WebKitNavigationAction* navigation 


) 


Description 


Free the WebKitNavigationAction. 


Available since: 2.6 
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Method 
WebKit2NavigationActionget_frame_name 
since: 2.40 


Declaration 


const char* 
webkit_navigation_action_get_frame_name ( 


WebKitNavigationAction* navigation 


) 


Description 


Gets the navigation target frame name. For example if navigation was triggered by clicking a link 
with a target attribute equal to “_blank”’, this will return the value of that attribute. In all other cases this 
function will return NULL. 


Available since: 2.40 


Return value 


Type: const char* 


The name of the new frame this navigation action targets or NULL. 


The data is owned by the instance. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 
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Method 


WebKit2NavigationActionget_modifiers 


since: 2.6 


Declaration 


guint 
webkit_navigation_action_get_modifiers ( 


WebKitNavigationAction* navigation 


) 


Description 


Return the modifier keys. 


Return a bitmask of GdkModifierType values describing the modifier keys that were in effect when 
the navigation was requested. 


Available since: 2.6 
Return value 


Type: guint 


The modifier keys. 
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Method 


WebKit | avigationActionget_mouse_button 


since: 2.6 


Declaration 


guint 
webkit_navigation_action_get_mouse_button ( 
WebKitNavigationAction* navigation 


) 


Description 


Return the number of the mouse button that triggered the navigation. 


Return the number of the mouse button that triggered the navigation, or 0 if the navigation was not started 
by a mouse event. 


Available since: 2.6 
Return value 


Type: guint 


The mouse button number or 0 
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Method 
WebKit2NavigationActionget_navigation_type 
since: 2.6 


Declaration 


WebKitNavigationType 
webkit_navigation_action_get_navigation_type ( 
WebKitNavigationAction* navigation 


) 


Description 


Return the type of action that triggered the navigation. 


Available since: 2.6 


Return value 


Type:|WebKitNavigationType 


A WebKitNavigationType. 
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Method 


WebKit2NavigationActionget_request 


since: 2.6 


Declaration 


WebKitURIRequest* 
webkit_navigation_action_get_request ( 
WebKitNavigationAction* navigation 


) 


Description 


Return the WebKitURIRequest associated with the navigation action. 


Modifications to the returned object are not taken into account when the request is sent over the network, 
and is intended only to aid in evaluating whether a navigation action should be taken or not. To modify 
requests before they are sent over the network the WebKitPage: :send-request signal can be 
used instead. 


Available since: 2.6 


Return value 


Type: |WebKitURIRequest 


A WebKitURIRequest. 


The data is owned by the instance. 
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Method 


WebKit | avigationActionis_redirect 


since: 2.20 


Declaration 


gboolean 
webkit_navigation_action_is_redirect ( 
WebKitNavigationAction* navigation 


) 


Description 


Returns whether the navigation was redirected. 
Available since: 2.20 

Return value 

Type: gboolean 


TRUE if the original navigation was redirected, FALSE otherwise. 
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Method 


WebKit | avigationActionis_user_gesture 


since: 2.6 


Declaration 


gboolean 
webkit_navigation_action_is_user_gesture ( 
WebKitNavigationAction* navigation 


) 


Description 


Return whether the navigation was triggered by a user gesture like a mouse click. 
Available since: 2.6 

Return value 

Type: gboolean 


Whether navigation action is a user gesture. 
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Struct 


WebKit2NetworkProxySettings 


since: 2.16 


Description 


struct WebKitNetworkProxySettings { 
/* No available fields */ 
} 


Configures network proxies. 


WebkKitNetworkProxySettings can be used to provide a custom proxy configuration to a 
WebKitWebContext. You need to call 
webkit_web_context_set_network_proxy_settings() with 
WEBKIT_NETWORK_PROXY_MODE_CUSTOM and a WebKitNetworkProxySettings. 


Available since: 2.16 


Constructors 


webkit_network_proxy_settings_new 


Create anew WebKitNetworkProxySettings with the given default_proxy_uri and 
ignore_hosts. 


since: 2.16 


Instance methods 


webkit_network_proxy_settings_add_proxy_for_scheme 


Adds a URI-scheme-specific proxy. 

since: 2.16 

Make a copy of the WebKitNetworkProxySettings. 
since: 2.16 

Free the WebKitNetworkProxySettings. 

since: 2.16 


Content 


@ |Description 
@ (Constructors 
e 


Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Functions 
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Function 
WebKit2NetworkProxySettingsnew 
since: 2.16 


Declaration 


WebKitNetworkProxySettings* 
webkit_network_proxy_settings_new ( 
const gchar* default_proxy_uri, 
const gchar* const* ignore_hosts 


) 


Description 


Create anew WebKitNetworkProxySettings with the given default_proxy_uri and 
ignore_hosts. 


The default proxy URI will be used for any URI that doesn’t match ignore_hosts, and doesn’t match 
any of the schemes added with webkit_network_proxy_settings_add_proxy_for_scheme(). If 
default_proxy_uri starts with “socks://’, it will be treated as referring to all three of the socks5, 
socks4a, and socks4 proxy types. 


ignore_hosts is a list of hostnames and IP addresses that the resolver should allow direct connections 
to. Entries can be in one of 4 formats: A hostname, such as “example.com’’, “.example.com’’, or 

“* example.com’”, any of which match “example.com” or any subdomain of it. An IPv4 or IPv6 address, 
such as “192.168.1.1”, which matches only that address. A hostname or IP address followed by a port, 
such as “example.com:80”, which matches whatever the hostname or IP address would match, but only for 


URLs with the (explicitly) indicated port. In the case of an IPv6 address, the address part must appear in 


brackets: “[::1]:443” An IP address range, given by a base address and prefix length, such as “fe80::/10”, 
which matches any address in that range. 


Note that when dealing with Unicode hostnames, the matching is done against the ASCII form of the 
name. Also note that hostname exclusions apply only to connections made to hosts identified by name, 
and IP address exclusions apply only to connections made to hosts identified by address. That is, if 
example.com has an address of 192.168.1.1, and ignore_hosts contains only “192.168.1.1”, then a 
connection to “example.com” will use the proxy, and a connection to 192.168.1.1” will not. 


Available since: 2.16 
Parameters 
default_proxy_uri 
Type: const gchar* 
The default proxy URI to use, or NULL. 
The argument can be NULL. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


ignore_hosts 
Type: An array of gchar* 
An optional list of hosts/IP addresses to not use a proxy for. 
The argument can be NULL. 
The array must be NULL-terminated. 


The data is owned by the caller of the function. 


Each element is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitNetworkProxySettings 


A new WebKitNetworkProxySettings. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

NetworkProxySettings 

Methods 
add_proxy_for_scheme]copy| 
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Method 


WebKit2NetworkProxySettingsadd_proxy_for_scheme 


since: 2.16 


Declaration 


void 
webkit_network_proxy_settings_add_proxy_for_scheme ( 
WebKitNetworkProxySettings* proxy_settings, 
const gchar* scheme, 
const gchar* proxy_uri 


) 


Description 


Adds a URI-scheme-specific proxy. 


URIs whose scheme matches uri_scheme will be proxied via proxy_uri. As with the default proxy 
URI, if proxy_uri starts with “socks://’, it will be treated as referring to all three of the socks5, 
socks4a, and socks4 proxy types. 


Available since: 2.16 


Parameters 
scheme 
Type: const gchar* 
The URI scheme to add a proxy for. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


proxy_uri 
Type: const gchar* 
The proxy URI to use for uri_scheme. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Methods 
add_proxy_for_scheme|copy]free 
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Method 
WebKit2NetworkProxySettingscopy 
since: 2.16 


Declaration 


WebKitNetworkProxySettings* 
webkit_network_proxy_settings_copy ( 

WebKitNetworkProxySettings* proxy_settings 
) 


Description 


Make a copy of the WebKitNetworkProxySettings. 


Available since: 2.16 


Return value 


Type: |WebKitNetworkProxySettings 


A copy of passed in WebKitNetworkProxySettings. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Methods 
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WebKit2NetworkProxySettingsfree 


since: 2.16 


Declaration |[src] 


void 

webkit_network_proxy_settings_free ( 
WebKitNetworkProxySettings* proxy_settings 

) 


Description 


Free the WebKitNetworkProxySettings. 


Available since: 2.16 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Instance methods 
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Struct 


WebKit20ptionMenultem 


since: 2.18 


Description 


struct WebKitOptionMenuItem { 
/* No available fields */ 
} 


One item of aWebKitOptionMenu. 


The WebKitOptionMenu is composed of WebKitOptionMenultems. A WebKitOptionMenultem 
always has a label and can contain a tooltip text. You can use the WebKitOptionMenultem of a 
WebKitOptionMenu to build your own menus. 


Available since: 2.18 


Instance methods 
webkit_option_menu_item_copy 
Make a copy of the WebKitOptionMenuItem. 


since: 2.18 


Free the WebKitOptionMenuItem. 

since: 2.18 

Get the label of aWebKitOptionMenuItem. 

since: 2.18 

Get the tooltip of aWebKitOptionMenuItem. 

since: 2.18 

Whether a WebKitOptionMenuItemis enabled. 
since: 2.18 

Whether a WebKit Opt ionMenulItenm is a group child. 
since: 2.18 

Whether a WebKit OptionMenulIten is a group label. 
since: 2.18 

Whether a WebKit Opt ionMenulIten is the currently selected one. 
since: 2.18 


Content 


° 
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API Version: 4.1 


Library Version: 2.42.4 
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Methods 
copy|free|get_label|get_tooltip}is_enabled]is_group_child]is_group_labellfis_selected 
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Method 
WebKit2OptionMenultemcopy 
since: 2.18 


Declaration 


WebKitOptionMenuItem* 
webkit_option_menu_item_copy ( 
WebKitOptionMenuItem* item 

) 


Description 


Make a copy of the WebKitOptionMenulItem. 


Available since: 2.18 


Return value 


Type: |WebKitOptionMenuItem 


A copy of passed in WebKit OptionMenulItem. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


copy|free}get_label]get_tooltipfis_enabledfis_group_childfis_group_labelfis_selected 
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Method 


WebKit2ZOptionMenulItemfree 


since: 2.18 


Declaration 


void 

webkit_option_menu_item_free ( 
WebKitOptionMenuItem* item 

) 


Description 


Free the WebKitOptionMenuItem. 


Available since: 2.18 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


copy|free}get_label]get_tooltipfis_enabledfis_group_childfis_group_labelfis_selected 
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Method 
WebKit2OptionMenultemget_label 
since: 2.18 


Declaration 


const gchar* 

webkit_option_menu_item_get_label ( 
WebKitOptionMenuItem* item 

) 


Description 


Get the label of a WebKitOptionMenuItem. 
Available since: 2.18 

Return value 

Type: const gchar* 

The label of item. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


copy|free}get_label]get_tooltipfis_enabledfis_group_childfis_group_labelfis_selected 
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Method 
WebKit2OptionMenulItembet_tooltip 
since: 2.18 


Declaration 


const gchar* 

webkit_option_menu_item_get_tooltip ( 
WebKitOptionMenuItem* item 

) 


Description 

Get the tooltip of aWebKitOptionMenuItem. 
Available since: 2.18 

Return value 

Type: const gchar* 

The tooltip of item, or NULL. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


copy|free}get_label]get_tooltipfis_enabledfis_group_childfis_group_labelfis_selected 
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Method 


WebKit2OptionMenultemis_enabled 


since: 2.18 


Declaration 


gboolean 

webkit_option_menu_item_is_enabled ( 
WebKitOptionMenuItem* item 

) 


Description 

Whether a WebKitOpt ionMenuItemis enabled. 
Available since: 2.18 

Return value 

Type: gboolean 


TRUE if the item is enabled or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


copy|free}get_label]get_tooltipfis_enabledfis_group_childfis_group_labelfis_selected 
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Method 


WebKit2OptionMenultemis_group_child 


since: 2.18 


Declaration 


gboolean 

webkit_option_menu_item_is_group_child ( 
WebKitOptionMenuItem* item 

) 


Description 


Whether a WebKit Opt ionMenulItenm is a group child. 
Available since: 2.18 

Return value 

Type: gboolean 


TRUE if the item is a group child or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
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copy|free}get_label]get_tooltipfis_enabledfis_group_childfis_group_labelfis_selected 
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Method 


WebKitZOptionMenulItemis_group_label 


since: 2.18 


Declaration 


gboolean 

webkit_option_menu_item_is_group_label ( 
WebKitOptionMenuItem* item 

) 


Description 


Whether a WebKit Opt ionMenulIten is a group label. 
Available since: 2.18 

Return value 

Type: gboolean 


TRUE if the item is a group label or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 


copy|free}get_label]get_tooltipfis_enabledfis_group_childfis_group_labelfis_selected 
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Method 


WebKit2OptionMenultemis_selected 


since: 2.18 


Declaration 


gboolean 

webkit_option_menu_item_is_selected ( 
WebKitOptionMenuItem* item 

) 


Description 


Whether a WebKit Opt ionMenulIten is the currently selected one. 
Available since: 2.18 

Return value 

Type: gboolean 


TRUE if the item is selected or FALSE otherwise. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Instance methods 
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Struct 


WebKit2PermissionStateQuery 


unstable since: 4.1 


Description 


struct WebKitPermissionStateQuery { 
/* No available fields */ 
} 


This query represents a user’s choice to allow or deny access to “powerful features” of the platform, as 


specified in the|Permissions W3C Specification 


When signalled by the WebKitWebView through the query—permission-state signal, the 
application has to eventually respond, via webkit_permission_state_query_finish(), 
whether it grants, denies or requests a dedicated permission prompt for the given query. 


When a WebKitPermissionStateQuery is not handled by the user, the user-agent is instructed to 
prompt the user for the given permission. 


Available since: 4.1 


Instance methods 


webkit_permission_state_query_finish 


Notify the web-engine of the selected permission state for the given query. This function should only be 
called as a response to the WebKitWebView: :query-permission-state signal. 


since: 2.40 
webkit_permission_state_query_get_name 
Get the permission name for which access is being queried. 


since: 2.40 


webkit_permission_state_query_get_security_origin 


Get the permission origin for which access is being queried. 
since: 2.40 

Atomically increments the reference count of query by one. 
since: 2.40 

Atomically decrements the reference count of query by one. 
since: 2.40 


Content 


: 
@ |Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
PermissionStateQuer 
Methods 
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Method 


WebKit2PermissionStateQueryfinish 


since: 2.40 


Declaration 


void 

webkit_permission_state_query_finish ( 
WebKitPermissionStateQuery* query, 
WebKitPermissionState state 

) 


Description 


Notify the web-engine of the selected permission state for the given query. This function should only be 
called as a response to the WebKitWebView: :query-permission-state signal. 


Available since: 2.40 


Parameters 


state 


Type:\(WebKitPermissionState 


A WebKitPermissionState. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
PermissionStateQuer 
Methods 
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Method 
WebKit2PermissionStateQueryget_name 
since: 2.40 


Declaration 


const gchar* 
webkit_permission_state_query_get_name ( 
WebKitPermissionStateQuery* query 


) 


Description 


Get the permission name for which access is being queried. 
Available since: 2.40 

Return value 

Type: const gchar* 

The permission name for query. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
PermissionStateQuer 
Methods 
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Method 
WebKit2PermissionStateQueryget_security_origin 
since: 2.40 


Declaration 


WebKitSecurityOrigin* 
webkit_permission_state_query_get_security_origin ( 
WebKitPermissionStateQuery* query 


) 


Description 


Get the permission origin for which access is being queried. 


Available since: 2.40 


Return value 


Type: |WebKitSecurityOrigin 


A WebKitSecurityOrigin representing the origin from which the query was emitted. 


The data is owned by the instance. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
PermissionStateQuer 
Methods 
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Method 
WebKit2PermissionStateQueryref 
since: 2.40 


Declaration 


WebKitPermissionStateQuery* 
webkit_permission_state_query_ref ( 
WebKitPermissionStateQuery* query 


) 


Description 


Atomically increments the reference count of query by one. 
This function is MT-safe and may be called from any thread. 


Available since: 2.40 


Return value 


Type: |WebKitPermissionStateQuery 


The passed WebKitPermissionStateQuery. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
PermissionStateQuer 
Methods 
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Method 
WebKit2PermissionStateQueryunref 
since: 2.40 


Declaration 


void 
webkit_permission_state_query_unref ( 
WebKitPermissionStateQuery* query 


) 


Description 


Atomically decrements the reference count of query by one. 


If the reference count drops to 0, all memory allocated by WebKitPermissionStateQuery is 
released. This function is MT-safe and may be called from any thread. 


Available since: 2.40 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Instance methods 
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Generated by[gi-docgen]2023.3 
Struct 


WebKit2ScriptDialog 


unstable since: 4.1 


Description 


struct WebKitScriptDialog { 
/* No available fields */ 
} 


Carries details to be shown in user-facing dialogs. 


Available since: 4.1 


Instance methods 


webkit_script_dialog_close 


Close dialog. 


since: 2.24 


webkit_script_dialog_confirm_set_confirmed 


Set whether the user confirmed the dialog. 

unstable since: 4.1 

Get the dialog type of aWebKitScriptDialog. 

unstable since: 4.1 

webkit_script_dialog_get_message 

Get the message of aWebKitScriptDialog. 

unstable since: 4.1 

Get the default text of aWebKitScriptDialog of type WEBKIT_SCRIPT_DIALOG_PROMPT. 
unstable since: 4.1 

Set the text entered by the user in the dialog. 

unstable since: 4.1 

webkit_script_dialog_re 

Atomically increments the reference count of dialog by one. 
since: 2.24 

Atomically decrements the reference count of dialog by one. 
since: 2.24 


Content 


° 
@ (Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
confirm_set_confirmed]|get_dialog_type prompt_get_default_text}prompt_set_text 
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Method 


WebKitScriptDialogclose 


since: 2.24 


Declaration 


void 
webkit_script_dialog_close ( 

WebKitScriptDialog* dialog 
) 


Description 


Close dialog. 


When handling a WebKit ScriptDialog asynchronously (webkit_script_dialog_ref() was called in 
WebKitWebView: :script-—dialog callback), this function needs to be called to notify that we are 
done with the script dialog. The dialog will be closed on destruction if this function hasn’t been 

called before. 


Available since: 2.24 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
confirm_set_confirmed]|get_dialog_type prompt_get_default_text}prompt_set_text 


Generated by 2023.3 
Method 


WebKit2ScriptDialogconfirm_set_confirmed 
Declaration 


void 
webkit_script_dialog_confirm_set_confirmed ( 
WebKitScriptDialog* dialog, 
gboolean confirmed 


) 


Description 


Set whether the user confirmed the dialog. 


This method is used for WEBKIT_SCRIPT_DIALOG_ CONFIRM and 
WEBKIT_SCRIPT_DIALOG_BEFORE_UNLOAD_CONF IRM dialogs when 

WebKitWebView: :script—dialog signal is emitted to set whether the user confirmed the dialog or 
not. The default implementation of WebKitWebView: :script—dialog signal sets TRUE when the 
OK or Stay buttons are clicked and FALSE otherwise. It’s an error to use this method with a 
WebKitScriptDialog that is not of type WEBKIT_SCRIPT_DIALOG_CONFIRM or 
WEBKIT_SCRIPT_DIALOG_BEFORE_UNLOAD_CONF IRM. 


Parameters 
confirmed 
Type: gboolean 


Whether user confirmed the dialog. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
confirm_set_confirmed]|get_dialog_type prompt_get_default_text}prompt_set_text 
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Method 


WebKit2ScriptDialogget_dialog_type 
Declaration 


WebKitScriptDialogType 

webkit_script_dialog_get_dialog_type ( 
WebKitScriptDialog* dialog 

) 


Description 


Get the dialog type of aWebKitScriptDialog. 


Return value 


Type:|WebKitScriptDialogType 


The WebKitScriptDialogType of dialog. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
confirm_set_confirmed]|get_dialog_type prompt_get_default_text}prompt_set_text 


Generated by[gi-docgen]2023.3 
Method 


WebKit2ScriptDialogget_message 
Declaration 


const gchar* 

webkit_script_dialog_get_message ( 
WebKitScriptDialog* dialog 

) 


Description 


Get the message of aWebKitScriptDialog. 
Return value 
Type: const gchar* 


The message of dialog. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
confirm_set_confirmed]|get_dialog_type prompt_get_default_text}prompt_set_text 
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Method 


WebKit2ScriptDialogprompt_get_default_text 
Declaration 


const gchar* 

webkit_script_dialog_prompt_get_default_text ( 
WebKitScriptDialog* dialog 

) 


Description 


Get the default text of aWebKitScriptDialog of type WEBKIT_SCRIPT_DIALOG_PROMPT. 


It’s an error to use this method with a WebKit ScriptDialog that is not of type 
WEBKIT_SCRIPT_DIALOG_PROMPT. 


Return value 
Type: const gchar* 
The default text of dialog. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
confirm_set_confirmed]|get_dialog_type prompt_get_default_text}prompt_set_text 
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Method 


WebKit2ScriptDialogprompt_set_text 
Declaration 


void 
webkit_script_dialog_prompt_set_text ( 
WebKitScriptDialog* dialog, 
const gchar* text 


) 


Description 


Set the text entered by the user in the dialog. 


This method is used for WEBKIT_SCRIPT_DIALOG_PROMPT dialogs when 

WebKitWebView: :script—dialog signal is emitted to set the text entered by the user. The default 
implementation of WebKitWebView: :script—dialog signal sets the text of the entry form when 
OK button is clicked, otherwise NULL is set. It’s an error to use this method with a 
WebKitScriptDialog that is not of type WEBKIT_SCRIPT_DIALOG_PROMPT 


Parameters 


text 


Type: const gchar* 


The text to set. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
confirm_set_confirmed]|get_dialog_type prompt_get_default_text}prompt_set_text 
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Method 
WebKit2ScriptDialogref 
since: 2.24 


Declaration 


WebKitScriptDialog* 
webkit_script_dialog_ref ( 

WebKitScriptDialog* dialog 
) 


Description 


Atomically increments the reference count of dialog by one. 
This function is MT-safe and may be called from any thread. 


Available since: 2.24 


Return value 


Type:|WebKitScriptDialog 


The passed in WebKitScriptDialog. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

ScriptDialog 

Methods 

confirm_set_confirmed]|get_dialog_type prompt_get_default_text}prompt_set_text 
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Method 


WebKit2ScriptDialogunref 


since: 2.24 


Declaration 


void 
webkit_script_dialog_unref ( 

WebKitScriptDialog* dialog 
) 


Description 


Atomically decrements the reference count of dialog by one. 


If the reference count drops to 0, all memory allocated by the WebKitScriptdialog is released. This 
function is MT-safe and may be called from any thread. 


Available since: 2.24 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


ScriptMessageRepl 
Instance methods 
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Struct 


WebKit2ScriptMessageReply 


since: 2.40 


Description 


struct WebKitScriptMessageReply { 
/* No available fields */ 
} 


A reply for a script message received. If no reply has been sent by the user, an automatically generated 
reply with undefined value with be sent. 


Available since: 2.40 


Instance methods 
webkit_script_message_reply_re 
Atomically increments the reference count of script_message_rep1]y by one. 


since: 2.40 


webkit_script_message_reply_return_error_message 


Reply to a script message with an error message. 

since: 2.40 

Reply to a script message with a value. 

since: 2.40 

Atomically decrements the reference count of script_message_rep]y by one. 
since: 2.40 


Content 


° 
@ (Methods 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Methods 
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Method 
WebKit2ScriptMessageReplyref 
since: 2.40 


Declaration 


WebKitScriptMessageReply* 
webkit_script_message_reply_ref ( 


WebKitScriptMessageReply* script_message_reply 
) 


Description 


Atomically increments the reference count of script_message_rep1]y by one. 


Available since: 2.40 


Return value 


Type:|WebKitScriptMessageReply 


The script_message_repl]y passed in. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


ScriptMessageRepl 


Methods 
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Method 


WebKit2ScriptMessageReplyreturn_error_message 


since: 2.40 


Declaration 


void 
webkit_script_message_reply_return_error_message ( 


WebKitScriptMessageReply* script_message_reply, 
const char* error_message 


) 


Description 


Reply to a script message with an error message. 
Available since: 2.40 
Parameters 
error_message 
Type: const char* 


An error message to return as specified by the user’s script message. 


The data is owned by the caller of the method. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 
Type 
ScriptMessageRepl 


Methods 
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Method 


WebKit2ScriptMessageReplyreturn_value 


since: 2.40 


Declaration 


void 

webkit_script_message_reply_return_value ( 
WebKitScriptMessageReply* script_message_reply, 
JSCValue* reply value 

) 


Description 


Reply to a script message with a value. 
This function can be called twice for passing the reply value in. 


Available since: 2.40 


Parameters 
reply_value 


Type: TSCValue 


Reply value of the provided script message. 


The data is owned by the caller of the method. 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 
ScriptMessageRepl 


Methods 
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Method 


WebKit2ScriptMessageReplyunref 


since: 2.40 


Declaration 


void 
webkit_script_message_reply_unref ( 


WebKitScriptMessageReply* script_message_reply 
) 


Description |[src] 
Atomically decrements the reference count of script_message_rep1]y by one. 


If the reference count drops to 0, all the memory allocated by the WebKit ScriptMessageRepl]y is 
released. This function is MT-safe and may be called from any thread. 


Available since: 2.40 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Constructors 


new\|new_for_uri 


Instance methods 
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Struct 


WebKit2SecurityOrigin 


since: 2.16 


Description 


struct WebKitSecurityOrigin { 
/* No available fields */ 
} 


A security boundary for websites. 


WebKitSecurityOrigin is a representation of a security domain defined by websites. A security 
origin consists of a protocol, a hostname, and an optional port number. 


Resources with the same security origin can generally access each other for client-side scripting or 
database access. When comparing origins, beware that if both protocol and host are NULL, the origins 
should not be treated as equal. 


Available since: 2.16 


Constructors 
webkit_security_origin_new| 
Create a new security origin from the provided protocol, host and port. 


since: 2.16 


webkit_security_origin_new_for_uri 


Create a new security origin from the provided. 


since: 2.16 


Instance methods 


webkit_security_origin_get_host 


Gets the hostname of origin. 
since: 2.16 

Gets the port of origin. 
since: 2.16 

Gets the protocol of origin. 


since: 2.16 


webkit_security_origin_is_opaque 


This function returns FALSE. 
deprecated: 2.32 since: 2.16 
Atomically increments the reference count of origin by one. 


since: 2.16 


webkit_security_origin_to_string 


Gets a string representation of origin. 

since: 2.16 

Atomically decrements the reference count of origin by one. 
since: 2.16 


Content 


@ |Description 
@ (Constructors 
e 


Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Functions 
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Function 


WebKit2SecurityOriginnew 


since: 2.16 


Declaration 


WebKitSecurityOrigin* 

webkit_security_origin_new ( 
const gchar* protocol, 
const gchar* host, 
guintl16 port 

) 


Description 


Create a new security origin from the provided protocol, host and port. 
Available since: 2.16 
Parameters 
protocol 
Type: const gchar* 


The protocol for the new origin. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


host 
Type: const gchar* 
The host for the new origin. 
The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


port 
Type: guint16 


The port number for the new origin, or 0 to indicate the default port for protocol. 


Return value 


Type: |WebKitSecurityOrigin 


A WebKitSecurityOrigin. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Functions 


Generated by[gi-docgen|2023.3 


Function 


WebKit IS ecurityOriginnew_for_uri 


since: 2.16 


Declaration 


WebKitSecurityOrigin* 
webkit_security_origin_new_for_uri ( 
const gchar* uri 


) 


Description 


Create a new security origin from the provided. 


Create a new security origin from the provided URI. Components of uri other than protocol, host, and 
port do not affect the created WebKit SecurityOrigin. 


Available since: 2.16 
Parameters 
url 


Type: const gchar* 


The URI for the new origin. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitSecurityOrigin 


A WebKitSecurityOrigin. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
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Method 


WebKit2SecurityOriginget_host 


since: 2.16 


Declaration 


const gchar* 
webkit_security_origin_get_host ( 
WebKitSecurityOrigin* origin 


) 


Description 


Gets the hostname of origin. 

It is reasonable for this to be NULL if its protocol does not require a host component. 
Available since: 2.16 

Return value 

Type: const gchar* 


The host of the WebKitSecurityOrigin. 


The data is owned by the instance. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
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Method 


WebKit2SecurityOriginget_port 


since: 2.16 


Declaration 


guint16 
webkit_security_origin_get_port ( 
WebKitSecurityOrigin* origin 


) 


Description 


Gets the port of origin. 


This function will always return 0 if the port is the default port for the given protocol. For example, 
http://example.com has the same security origin as http://example.com:80, and this function will return 0 
fora WebKitSecurityOrigin constructed from either URI. 


Available since: 2.16 


Return value 


Type: guint16 


The port of the WebKitSecurityOrigin. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
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Method 


WebKit2SecurityOriginget_protocol 


since: 2.16 


Declaration 


const gchar* 
webkit_security_origin_get_protocol ( 
WebKitSecurityOrigin* origin 


) 


Description 


Gets the protocol of origin. 
Available since: 2.16 
Return value 

Type: const gchar* 


The protocol of the WebKitSecurityOrigin. 


The data is owned by the instance. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
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Method 


WebKit2SecurityOriginis_opaque 


deprecated: 2.32 since: 2.16 


Declaration 


gboolean 
webkit_security_origin_is_opaque ( 
WebKitSecurityOrigin* origin 


) 


Description 


This function returns FALSE. 


This function returns FALSE. WebKit SecurityOrigin is now a simple wrapper around a triplet, and 
no longer represents an origin as defined by web standards that may be opaque. 


Available since: 2.16 
Deprecated since: 2.32 


Please do not use it in newly written code. 


Return value 
Type: gboolean 


FALSE. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
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Method 


WebKit2SecurityOriginref 


since: 2.16 


Declaration 


WebKitSecurityOrigin* 
webkit_security_origin_ref ( 
WebKitSecurityOrigin* origin 


) 


Description 


Atomically increments the reference count of origin by one. 
This function is MT-safe and may be called from any thread. 
Available since: 2.16 

Return value 


Type: |WebKitSecurityOrigin 


The passed WebKitSecurityOrigin. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 


Generated by[gi-docgen|2023.3 
Method 


WebKit2SecurityOriginto_string 


since: 2.16 


Declaration 


gchar* 
webkit_security_origin_to_string ( 
WebKitSecurityOrigin* origin 


) 


Description 


Gets a string representation of origin. 

The string representation is a valid URI with only protocol, host, and port components, or NULL. 
Available since: 2.16 

Return value 

Type: gchar* 


A URI representing origin. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 
The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Methods 
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Method 


WebKit2SecurityOriginunref 


since: 2.16 


Declaration 


void 
webkit_security_origin_unref ( 
WebKitSecurityOrigin* origin 


) 


Description 


Atomically decrements the reference count of origin by one. 


If the reference count drops to 0, all memory allocated by WebKit SecurityOrigin is released. This 
function is MT-safe and may be called from any thread. 


Available since: 2.16 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
UserContentFilter| 


Instance methods 
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Struct 


WebKit2UserContentFilter 


since: 2.24 


Description 


struct WebKitUserContentFilter { 
/* No available fields */ 
} 


A compiled set of rules which applied to resource loads. 


Available since: 2.24 


Instance methods 


webkit_user_content_filter_get_identifier 


Obtain the identifier previously used to save the user_content_filter. 


since: 2.24 


Atomically increments the reference count of user_content_filter by one. 
since: 2.24 
Atomically decrements the reference count of user_content_filter by one. 
since: 2.24 


Content 


° 
@ (Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

UserContentFilter 

Methods 
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Method 
WebKit2UserContentFilterget_identifier 
since: 2.24 


Declaration 


const char* 
webkit_user_content_filter_get_identifier ( 
WebKitUserContentFilter* user_content_filter 


) 


Description 


Obtain the identifier previously used to save the user_content_filter. 


Obtain the identifier previously used to save the user_content_filter in the 
WebKitUserContentFilterStore. 


Available since: 2.24 
Return value 
Type: const char* 


The identifier for the filter. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

UserContentFilter 

Methods 
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Method 
WebKit2UserContentFilterref 
since: 2.24 


Declaration 


WebKitUserContentFilter* 
webkit_user_content_filter_ref ( 
WebKitUserContentFilter* user_content_filter 


) 


Description 


Atomically increments the reference count of user_content_filter by one. 
This function is MT-safe and may be called from any thread. 


Available since: 2.24 


Return value 


Type: |WebKitUserContentFilter 


The user_content_filter passed in. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
UserContentFilter| 


Methods 
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Method 
WebKit2UserContentFilterunref 
since: 2.24 


Declaration 


void 
webkit_user_content_filter_unref ( 
WebKitUserContentFilter* user_content_filter 


) 


Description 


Atomically decrements the reference count of user_content_filter by one. 


If the reference count drops to 0, all the memory allocated by the WebKitUserContentFilter is 
released. This function is MT-safe and may be called from any thread. 


Available since: 2.24 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 


Constructors 


new\|new_for_world 


Instance methods 
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Struct 


WebKit2UserScript 


since: 2.6 


Description 


struct WebKitUserScript { 
/* No available fields */ 
} 


A JavaScript snippet which can be injected in loaded pages. 


Available since: 2.6 


Constructors 
webkit_user_script_new 
Creates a new user script. 


since: 2.6 


webkit_user_script_new_for_world 


Creates a new user script for script world with name world_name. 


since: 2.22 


Instance methods 

Atomically increments the reference count of user_script by one. 
since: 2.6 

Atomically decrements the reference count of user_script by one. 
since: 2.6 


Content 


@ |Description 
@ (Constructors 
e 


Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Functions 
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Function 


WebKit2UserScriptnew 


since: 2.6 


Declaration 


WebKitUserScript* 

webkit_user_script_new ( 
const gchar* source, 
WebKitUserContentInjectedFrames injected_frames, 
WebKitUserScriptInjectionTime injection_time, 
const gchar* const* allow_list, 
const gchar* const* block_list 


Description 


Creates a new user script. 


Scripts can be applied to some URIs only by passing non-null values for allow_list or block_list. 
Passing a NULL allow_list implies that all URIs are on the allow_list. The script is applied if an URI 
matches the allow_list and not the block_list. URI patterns must be of the form 
[protocol]://[host]/[path], where the host and path components can contain the wildcard 
character (*) to represent zero or more other characters. 


Available since: 2.6 


Parameters 

source 
Type: const gchar* 
Source code of the user script. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


injected_frames 


Type:\(WebKitUserContentInjectedFrames 


A WebKitUserContentInjectedFrames value. 


injection_time 


Type:\(WebKitUserScriptInjectionTime 


A WebKitUserScriptInjectionTime value. 


allow_list 
Type: An array of gchar* 
An allow_list of URI patterns or NULL. 
The argument can be NULL. 
The array must be NULL-terminated. 


The data is owned by the caller of the function. 


Each element is a NUL terminated UTF-8 string. 


block_list 


Type: An array of gchar* 


A block_list of URI patterns or NULL. 


The argument can be NULL. 
The array must be NULL-terminated. 
The data is owned by the caller of the function. 


Each element is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitUserScript 


Anew WebKitUserScript. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Functions 
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Function 


WebKit@UserScriptnew_for_world 


since: 2.22 


Declaration 


WebKitUserScript* 
webkit_user_script_new_for_world ( 
const gchar* source, 
WebKitUserContentInjectedFrames injected_frames, 
WebKitUserScriptInjectionTime injection_time, 
const gchar* world_name, 
const gchar* const* allow_list, 
const gchar* const* block_list 


Description 


Creates a new user script for script world with name world_name. 
See webkit_user_script_new() fora full description. 
Available since: 2.22 

Parameters 


Source 


Type: const gchar* 
Source code of the user script. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


injected_frames 


Type:\(WebKitUserContentInjectedFrames 


A WebKitUserContentInjectedFrames value. 


injection_time 


Type:|(WebKitUserScriptiInjectionTime 


A WebKitUserScriptInjectionTime value. 


world_name 
Type: const gchar* 
The name of a WebKitScriptWorld. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


allow_list 
Type: An array of gchar* 
An allow_list of URI patterns or NULL. 
The argument can be NULL. 
The array must be NULL-terminated. 


The data is owned by the caller of the function. 


Each element is a NUL terminated UTF-8 string. 


block_list 
Type: An array of gchar* 
A block_list of URI patterns or NULL. 
The argument can be NULL. 
The array must be NULL-terminated. 


The data is owned by the caller of the function. 


Each element is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitUserScript 


Anew WebKitUserScript. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 


WebKit2UserScriptref 


since: 2.6 


Declaration 


WebKitUserScript* 
webkit_user_script_ref ( 
WebKitUserScript* user_script 


) 


Description 


Atomically increments the reference count of user_script by one. 
This function is MT-safe and may be called from any thread. 


Available since: 2.6 


Return value 


Type: |WebKitUserScript 


The passed WebKitUserScript. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 


WebKit2UserScriptunref 


since: 2.6 


Declaration 


void 
webkit_user_script_unref ( 
WebKitUserScript* user_script 


) 


Description 


Atomically decrements the reference count of user_script by one. 


If the reference count drops to 0, all memory allocated by WebKitUserScript is released. This 
function is MT-safe and may be called from any thread. 


Available since: 2.6 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Constructors 


new\|new_for_world 


Instance methods 
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Struct 
WebKit2UserStyleSheet 
since: 2.6 


Description 


struct WebKitUserStyleSheet { 
/* No available fields */ 
} 


A CSS style sheet which can be injected in loaded pages. 


Available since: 2.6 


Constructors 


webkit_user_style_sheet_new 


Creates a new user style sheet. 


since: 2.6 


webkit_user_style_sheet_new_for_world 


Creates a new user style sheet for script world. 


since: 2.22 


Instance methods 


webkit_user_style_sheet_re 


Atomically increments the reference count of user_style_sheet by one. 
since: 2.6 
Atomically decrements the reference count of user_style_sheet by one. 
since: 2.6 


Content 


@ |Description 
@ (Constructors 
e 


Methods 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
UserStyleSheet 


Functions 
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Function 
WebKit2UserStyleSheetnew 
since: 2.6 


Declaration 


WebKitUserStyleSheet* 

webkit_user_style_sheet_new ( 
const gchar* source, 
WebKitUserContentInjectedFrames injected_frames, 
WebKitUserStyleLevel level, 
const gchar* const* allow_list, 
const gchar* const* block_list 


Description 


Creates a new user style sheet. 


Style sheets can be applied to some URIs only by passing non-null values for allow_list or 
block_list. Passing a NULL allow_list implies that all URIs are on the allow_list. The style sheet is 
applied if an URI matches the allow_list and not the block_list. URI patterns must be of the form 
[protocol]://[host]/[path], where the host and path components can contain the wildcard 
character (*) to represent zero or more other characters. 


Available since: 2.6 


Parameters 
source 
Type: const gchar* 
Source code of the user style sheet. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


injected_frames 


Type:\(WebKitUserContentInjectedFrames 


A WebKitUserContentInjectedFrames value. 


level 


Type:|WebKitUserStyleLevel 


A WebKitUserStyleLevel. 


allow_list 
Type: An array of gchar* 
An allow_list of URI patterns or NULL. 
The argument can be NULL. 
The array must be NULL-terminated. 


The data is owned by the caller of the function. 


Each element is a NUL terminated UTF-8 string. 


block_list 


Type: An array of gchar* 


A block_list of URI patterns or NULL. 


The argument can be NULL. 
The array must be NULL-terminated. 
The data is owned by the caller of the function. 


Each element is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitUserStyleSheet 


A new WebKitUserStyleSheet. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
UserStyleSheet 


Functions 
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Function 
WebKit J serStyleSheetnew_for_world 
since: 2.22 


Declaration 


WebKitUserStyleSheet* 
webkit_user_style_sheet_new_for_world ( 
const gchar* source, 
WebKitUserContentInjectedFrames injected_frames, 
WebKitUserStyleLevel level, 
const gchar* world_name, 
const gchar* const* allow_list, 
const gchar* const* block_list 


Description 


Creates a new user style sheet for script world. 


Creates a new user style sheet for script world with name world_name. See 
webkit_user_style_sheet_new() fora full description. 


Available since: 2.22 


Parameters 
source 
Type: const gchar* 
Source code of the user style sheet. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


injected_frames 


Type:\(WebKitUserContentInjectedFrames 


A WebKitUserContentInjectedFrames value. 


level 


Type:|WebKitUserStyleLevel 


A WebKitUserStyleLevel. 


world_name 
Type: const gchar* 
The name of a WebKitScriptWorld. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


allow_list 
Type: An array of gchar* 


An allow_list of URI patterns or NULL. 


The argument can be NULL. 
The array must be NULL-terminated. 
The data is owned by the caller of the function. 


Each element is a NUL terminated UTF-8 string. 


block_list 
Type: An array of gchar* 
A block_list of URI patterns or NULL. 
The argument can be NULL. 
The array must be NULL-terminated. 


The data is owned by the caller of the function. 


Each element is a NUL terminated UTF-8 string. 


Return value 


Type: |WebKitUserStyleSheet 


A new WebKitUserStyleSheet. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 
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WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
UserStyleSheet 


Methods 
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Method 
WebKitUserStyleSheetref 
since: 2.6 


Declaration 


WebKitUserStyleSheet* 
webkit_user_style_sheet_ref ( 

WebKitUserStyleSheet* user_style_sheet 
) 


Description |[src] 
Atomically increments the reference count of user_style_sheet by one. 
This function is MT-safe and may be called from any thread. 


Available since: 2.6 


Return value 


Type: |WebKitUserStyleSheet 


The passed WebKitUserStyleSheet. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
UserStyleSheet 


Methods 
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Method 


WebKitUserStyleSheetunref 


since: 2.6 


Declaration 


void 

webkit_user_style_sheet_unref ( 
WebKitUserStyleSheet* user_style_sheet 

) 


Description 


Atomically decrements the reference count of user_style_sheet by one. 


If the reference count drops to 0, all memory allocated by WebKitUserStyleSheet is released. This 
function is MT-safe and may be called from any thread. 


Available since: 2.6 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Instance methods 
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Struct 


WebKit2/WebsiteData 


since: 2.16 


Description 


struct WebKitWebsiteData { 
/* No available fields */ 
} 


Data stored locally by a web site. 


WebKitWebsiteData represents data stored in the client by a particular website. A website is normally a 
set of URLs grouped by domain name. You can get the website name, which is usually the domain, with 
webkit_website_data_get_name(). Documents loaded from the file system, like file:// URIs, are all 
grouped in the same WebKitWebsiteData with the name “Local files”. 


A website can store different types of data in the client side. WebKitWebsiteDataTypes is an enum 
containing all the possible data types; use webkit_website_data_get_types () to get the 
bitmask of data types. It’s also possible to know the size of the data stored for some of the 
WebKitWebsiteDataTypes by using webkit_website_data_get_size(). 


A list of WebKitWebsiteData can be retrieved with webkit_website_data_manager_fetch(). See 
WebKitWebsiteDataManager for more information. 


Available since: 2.16 


Instance methods 


[webkit_website_data_get_name| 

Gets the name of WebKitWebsiteData. 

since: 2.16 

[webkit_website_data_get_size] 

Gets the size of the data of types types ina WebKitWebsiteData. 

since: 2.16 

webkit_website_data_get_types 

Gets the types of data stored in the client fora WebKitWebsiteData. 
since: 2.16 

Atomically increments the reference count of website_data by one. 

since: 2.16 

Atomically decrements the reference count of website_data by one. 


since: 2.16 


Content 


° 
@ |Methods 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
WebsiteData 
Methods 
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Method 
WebKit2WebsiteDataget_name 
since: 2.16 


Declaration 


const char* 
webkit_website_data_get_name ( 

WebKitWebsiteData* website_data 
) 


Description 


Gets the name of WebKitWebsiteData. 


This is the website name, normally represented by a domain or host name. All local documents are 
grouped in the same WebKitWebsiteData using the name “Local files”. 


Available since: 2.16 
Return value 
Type: const char* 


The website name of website data. 


The data is owned by the instance. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
WebsiteData 
Methods 
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Method 
WebKit2WebsiteDataget_size 
since: 2.16 


Declaration 


guinté4 

webkit_website_data_get_size ( 
WebKitWebsiteData* website_data, 
WebKitWebsiteDataTypes types 

) 


Description 


Gets the size of the data of types types ina WebKitWebsiteData. 


Note that currently the data size is only known for WEBKIT_WEBSITE_DATA_DISK_CACHE data type 
so for all other types 0 will be returned. 


Available since: 2.16 


Parameters 


types 


Type:\WebKitWebsiteDataTypes 


A bitmask of WebKitWebsiteDataTypes. 


Return value 
Type: guint 64 


The size of website_data for the given types. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
WebsiteData 
Methods 
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Method 
WebKitZWebsiteDataget_types 
since: 2.16 


Declaration 


WebKitWebsiteDataTypes 
webkit_website_data_get_types ( 

WebKitWebsiteData* website_data 
) 


Description 


Gets the types of data stored in the client fora WebKitWebsiteData. 
These are the types actually present, not the types queried with webkit_website_data_manager_fetch(). 


Available since: 2.16 


Return value 


Type: |WebKitWebsiteDataTypes 


A bitmask of WebKitWebsiteDataTypes in website_data. 
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API Version: 4.1 


Library Version: 2.42.4 


Type 
Methods 
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Method 


WebKit2WebsiteDataref 


since: 2.16 


Declaration 


WebKitWebsiteData* 
webkit_website_data_ref ( 

WebKitWebsiteData* website_data 
) 


Description 


Atomically increments the reference count of website_data by one. 
This function is MT-safe and may be called from any thread. 


Available since: 2.16 


Return value 


Type: |WebKitWebsiteData 


The passed WebKitWebsiteData. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

Methods 

Generated by[gi-docgen|2023.3 


Method 
WebKit2WebsiteDataunref 
since: 2.16 


Declaration 


void 

webkit_website_data_unref ( 
WebKitWebsiteData* website_data 

) 


Description 


Atomically decrements the reference count of website_data by one. 


If the reference count drops to 0, all memory allocated by WebKitWebsiteData is released. This 
function is MT-safe and may be called from any thread. 


Available since: 2.16 


| 


WebKit2 
API Version: 4.1 


Library Version: 2.42.4 


Type 
Web ViewSessionState 


Constructors 


5 


ew) 


Instance methods 


Generated by[gi-docgen]2023.3 


Struct 


WebKit2/WebViewSessionState 


since: 2.12 


Description 


struct WebKitWebViewSessionState { 
/* No available fields */ 
} 


Handles serialization of a web view’s browsing state. 


Available since: 2.12 


Constructors 


webkit_web_view_session_state_new 


Creates anew WebKitWebViewSessionState from serialized data. 


since: 2.12 


Instance methods 


webkit_web_view_session_state_re 
Atomically increments the reference count of state by one. 


since: 2.12 


webkit_web_view_session_state_serialize 


Serializes aWebKitWebViewSessionState. 

since: 2.12 

Atomically decrements the reference count of state by one. 
since: 2.12 


Content 


@ |Description 
@ (Constructors 
e 


Methods 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
WebViewSessionState 


Functions 


Generated by[gi-docgen|2023.3 


Function 
WebKit2\WebViewSessionStatenew 
since: 2.12 


Declaration 


WebKitWebViewSessionState* 

webkit_web_view_session_state_new ( 
GBytes* data 

) 


Description 


Creates anew WebKitWebViewSessionState from serialized data. 
Available since: 2.12 
Parameters 
data 
Type: GBytes 
A GBytes. 


The data is owned by the caller of the function. 


Return value 


Type: |WebKitWebViewSessionState 


A new WebKitWebViewSessionState, or NULL if data doesn’t contain a valid serialized 
WebKitWebViewSessionState. 


The caller of the function takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Methods 


Generated by[gi-docgen|2023.3 


Method 
WebKit2iWeb ViewSessionStateref 
since: 2.12 


Declaration 


WebKitWebViewSessionState* 
webkit_web_view_session_state_ref ( 

WebKitWebViewSessionState* state 
) 


Description 


Atomically increments the reference count of state by one. 
This function is MT-safe and may be called from any thread. 


Available since: 2.12 


Return value 


Type: |WebKitWebViewSessionState 


The passed in WebKitWebViewSessionState. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Methods 


Generated by[gi-docgen|2023.3 


Method 
WebKit2Web ViewSessionStateserialize 
since: 2.12 


Declaration 


GBytes* 

webkit_web_view_session_state_serialize ( 
WebKitWebViewSessionState* state 

) 


Description 


Serializes a WebKitWebViewSessionState. 


Available since: 2.12 


Return value 
Type: GBytes 
A GBytes containing the state serialized. 


The caller of the method takes ownership of the data, and is responsible for freeing it. 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Methods 


Generated by[gi-docgen|2023.3 


Method 
WebKit2\Web ViewSessionStateunref 
since: 2.12 


Declaration 


void 

webkit_web_view_session_state_unref ( 
WebKitWebViewSessionState* state 

) 


Description 


Atomically decrements the reference count of st ate by one. 


If the reference count drops to 0, all memory allocated by the WebKitWebViewSessionState Is 
released. This function is MT-safe and may be called from any thread. 


Available since: 2.12 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

AuthenticationScheme 
Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2AuthenticationScheme 


since: 2.2 


Declaration 


enum WebKit2.AuthenticationScheme 


Description 


Enum values representing the authentication scheme. 


Available since: 2.2 


Members 


WEBKIT_AUTHENTICATION_SCHEME_DEFAULT 


The default authentication scheme of WebKit. 


@ Value: 1 
@ Nickname: default 
@ Available since: 2.2 


WEBKIT_AUTHENTICATION_SCHEME _HTTP_BASIC 


Basic authentication scheme as defined in RFC 2617. 


@ Value: 2 
@ Nickname: http-basic 
@ Available since: 2.2 


WEBKIT_AUTHENTICATION_SCHEME_HTTP_DIGEST 


Digest authentication scheme as defined in RFC 2617. 


@ Value: 3 
@ Nickname: http-digest 
e@ Available since: 2.2 


WEBKIT_AUTHENTICATION_SCHEME_HTML_FORM 


HTML Form authentication. 


@ Value: 4 
@ Nickname: html—-form 
e@ Available since: 2.2 


WEBKIT_AUTHENTICATION_SCHEME_NTLM 


NTLM Microsoft proprietary authentication scheme. 


@ Value: 5 
@ Nickname: nt1lm 
e@ Available since: 2.2 


WEBKIT_AUTHENTICATION_SCHEME NEGOTIATE 


Negotiate (or SPNEGO) authentication scheme as defined in RFC 4559. 


@ Value: 6 
@ Nickname: negotiate 
@ Available since: 2.2 


WEBKIT_AUTHENTICATION_SCHEME _CLIENT_CERTIFICATE_REQUESTED 


Client Certificate Authentication (see RFC 2246). 


@ Value: 7 
@ Nickname: client-certificate-requested 
e@ Available since: 2.2 


WEBKIT_AUTHENTICATION_SCHEME _SERVER_TRUST_EVALUATION_REQUESTED 


Server Trust Authentication. 


@ Value: 8 
@ Nickname: server-trust-—evaluation-requested 
e@ Available since: 2.2 


WEBKIT_AUTHENTICATION_SCHEME _CLIENT_CERTIFICATE_PIN_REQUESTED 


Client certificate PIN required for use. Since: 2.34 


@ Value: 9 
@ Nickname: client-certificate-pin-requested 
e@ Available since: 2.2 


WEBKIT_AUTHENTICATION_SCHEME UNKNOWN 


Authentication scheme unknown. 


@ Value: 100 
@ Nickname: unknown 
e@ Available since: 2.2 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 
AutomationBrowsingContextPresentation 
Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2AutomationBrowsingContextPresentation 


since: 2.28 


Declaration 


enum WebKit2.AutomationBrowsingContextPresentation 


Description 


Enum values used for determining the automation browsing context presentation. 


Available since: 2.28 


Members 


WEBKIT_AUTOMATION_BROWSING_CONTEXT_PRESENTATION_WINDOW 


A window. 


@ Value: 0 
@ Nickname: window 
@ Available since: 2.28 


WEBKIT AUTOMATION BROWSING CONTEXT_PRESENTATION_TAB 
A tab. 


@ Value: 1 
@ Nickname: tab 
@ Available since: 2.28 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

AutoplayPolic 

Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2AutoplayPolicy 


since: 2.30 


Declaration 


enum WebKit2.AutoplayPolicy 


Description 


Enum values used to specify autoplay policies. 


Available since: 2.30 


Members 


WEBKIT _AUTOPLAY_ALLOW 


Do not restrict autoplay. 


@ Value: 0 
@ Nickname: allow 
@ Available since: 2.30 


WEBKIT_AUTOPLAY_ALLOW_WITHOUT_SOUND 


Allow videos to autoplay if they have no audio track, or if their audio track is muted. 


@ Value: 1 
@ Nickname: allow-without-sound 
@ Available since: 2.30 


WEBKIT AUTOPLAY DENY 


Never allow autoplay. 


@ Value: 2 
@ Nickname: deny 
e@ Available since: 2.30 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
CacheModel 


Generated by[gi-docgen|2023.3 


Enumeration 


W ebKit2;CacheModel 


unstable since: 4.1 


Declaration 


enum WebKit2.CacheModel 


Description 


Enum values used for determining the WebKitWebContext cache model. 


Available since: 4.1 


Members 


WEBKIT_CACHE_MODEL_DOCUMENT_VIEWER 


Disable the cache completely, which substantially reduces memory usage. Useful for applications 
that only access a single local file, with no navigation to other pages. No remote resources will 
be cached. 


@ Value: 0 
@ Nickname: document-viewer 
@ Available since: 4.1 


WEBKIT_CACHE_MODEL_WEB_BROWSER 


Improve document load speed substantially by caching a very large number of resources and 
previously viewed content. 


@ Value: 1 
@ Nickname: web-browser 
e@ Available since: 4.1 


WEBKIT_CACHE_MODEL_DOCUMENT_BROWSER 


A cache model optimized for viewing a series of local files — for example, a documentation viewer 
or a website designer. WebKit will cache a moderate number of resources. 


@ Value: 2 
@ Nickname: document-browser 
e@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Generated by[gi-docgen]2023.3 


Enumeration 


WebKit2;VContextMenuAction 


unstable since: 4.1 


Declaration 


enum WebKit2.ContextMenuAction 


Description 


Enum values used to denote the stock actions for WebKitContextMenultems. 


Available since: 4.1 


Members 


WEBKIT_CONTEXT_MENU_ACTION_NO_ACTION 


No action, used by separator menu items. 


@ Value: 0 
@ Nickname: no-action 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_OPEN_LINK 


Open current link. 


@ Value: 1 
@ Nickname: open-link 
@ Available since: 4.1 


WEBKIT CONTEXT _MENU_ACTION_OPEN_LINK_IN_NEW_WINDOW 


Open current link in a new window. 


@ Value: 2 
@ Nickname: open-link-in-new-window 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_DOWNLOAD_LINK_TO_DISK 


Download link destination. 


@ Value: 3 
@ Nickname: download-link-to-disk 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_COPY_LINK_TO_CLIPBOARD 


Copy link location to the clipboard. 


@ Value: 4 
@ Nickname: copy-link-to-clipboard 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_OPEN_IMAGE_IN_NEW_WINDOW 


Open current image in a new window. 


@ Value: 5 
@ Nickname: open-image-in-new-window 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_DOWNLOAD_IMAGE_TO_DISK 


Download current image. 


@ Value: 6 
@ Nickname: download-image-to-disk 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_COPY_IMAGE_TO_CLIPBOARD 


Copy current image to the clipboard. 


@ Value: 7 
@ Nickname: copy-image-to-clipboard 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_COPY_IMAGE_URL_TO_CLIPBOARD 


Copy current image location to the clipboard. 


@ Value: 8 
@ Nickname: copy—image-url-to-clipboard 
@ Available since: 4.1 
WEBKIT CONTEXT_MENU_ACTION_OPEN_FRAME IN NEW_WINDOW 


Open current frame in a new window. 


@ Value: 9 
@ Nickname: open-frame-—in-new-window 
@ Available since: 4.1 

WEBKIT_ CONTEXT_MENU_ACTION_GO_BACK 


Load the previous history item. 


@ Value: 10 
@ Nickname: go-back 
@ Available since: 4.1 
WEBKIT_ CONTEXT_MENU_ACTION_GO_FORWARD 


Load the next history item. 


@ Value: 11 
@ Nickname: go-forward 
@ Available since: 4.1 
WEBKIT CONTEXT _MENU_ACTION_STOP 


Stop any ongoing loading operation. 


@ Value: 12 
@ Nickname: stop 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_RELOAD 


Reload the contents of current view. 


@ Value: 13 
e Nickname: reload 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_COPY 


Copy current selection the clipboard. 


@ Value: 14 
@ Nickname: copy 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_CUT 


Cut current selection to the clipboard. 


@ Value: 15 
@ Nickname: cut 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_PASTE 


Paste clipboard contents. 


@ Value: 16 
@ Nickname: paste 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_DELETE 


Delete current selection. 


@ Value: 17 
@ Nickname: delete 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_SELECT_ALL 


Select all text. 


@ Value: 18 
@e Nickname: select-all 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_INPUT_METHODS 


Input methods menu. 


@ Value: 19 
@ Nickname: input-methods 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_UNICODE 


Unicode menu. 


@ Value: 20 
@ Nickname: unicode 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_SPELLING_GUESS 


A proposed replacement for a misspelled word. 


@ Value: 21 
@ Nickname: spelling-guess 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_NO_GUESSES_FOUND 


An indicator that spellchecking found no proposed replacements. 


@ Value: 22 
@ Nickname: no-guesses-—found 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_IGNORE_SPELLING 


Causes the spellchecker to ignore the word for this session. 


@ Value: 23 
@ Nickname: ignore-spelling 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_LEARN_SPELLING 


Causes the spellchecker to add the word to the dictionary. 


@ Value: 24 
@ Nickname: learn-spelling 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_IGNORE_GRAMMAR 


Ignore grammar. 


@ Value: 25 
@ Nickname: ignore-grammar 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_FONT_MENU 


Font options menu. 


@ Value: 26 
@ Nickname: font-menu 
e@ Available since: 4.1 


WEBKIT CONTEXT _MENU_ACTION_ BOLD 
Bold. 


@ Value: 27 
@ Nickname: bold 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_ITALIC 


Italic. 


@ Value: 28 
@ Nickname: italic 
@ Available since: 4.1 
WEBKIT CONTEXT _MENU_ACTION_UNDERLINE 


Underline. 


@ Value: 29 
@ Nickname: underline 
@ Available since: 4.1 
WEBKIT CONTEXT _MENU_ACTION_OUTLINE 


Outline. 


@ Value: 30 
@ Nickname: outline 
@ Available since: 4.1 
WEBKIT CONTEXT _MENU_ACTION_INSPECT_ELEMENT 


Open current element in the inspector. 


@ Value: 31 
@ Nickname: inspect-element 
@ Available since: 4.1 
WEBKIT CONTEXT _MENU_ACTION_OPEN_VIDEO_IN_NEW_WINDOW 


Open current video element in a new window. 


@ Value: 32 
@ Nickname: open-video-in-new-window 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_OPEN_AUDIO_IN_NEW_WINDOW 


Open current audio element in a new window. 


@ Value: 33 
@ Nickname: open-audio—in-new-window 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_COPY_VIDEO_LINK_TO_CLIPBOARD 


Copy video link location in to the clipboard. 


@ Value: 34 
@ Nickname: copy-video-link-to-clipboard 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_COPY_AUDIO_LINK_TO_CLIPBOARD 


Copy audio link location in to the clipboard. 


@ Value: 35 
@ Nickname: copy—audio-link-to-clipboard 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_TOGGLE_MEDIA_CONTROLS 


Enable or disable media controls. 


@ Value: 36 
@ Nickname: toggle-media-controls 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_TOGGLE_MEDIA_LOOP 


Enable or disable media loop. 


@ Value: 37 
@ Nickname: toggle-media-loop 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_ENTER_VIDEO_FULLSCREEN 


Show current video element in fullscreen mode. 


@ Value: 38 
@ Nickname: enter-video-fullscreen 
e@ Available since: 4.1 


WEBKIT CONTEXT _MENU_ACTION_MEDIA PLAY 


Play current media element. 


@ Value: 39 
@ Nickname: media-play 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_MEDIA_PAUSE 


Pause current media element. 


@ Value: 40 
@ Nickname: media-pause 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_MEDIA_ MUTE 


Mute current media element. 


@ Value: 41 
@e Nickname: media-mute 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_DOWNLOAD_VIDEO_TO_DISK 


Download video to disk. Since 2.2 


@ Value: 42 
@ Nickname: download-video-to-disk 
@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_DOWNLOAD_AUDIO_TO_DISK 


Download audio to disk. Since 2.2 


@ Value: 43 
@ Nickname: download-audio-to-disk 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_INSERT_EMOJI 


Insert an emoji. Since 2.26 


@ Value: 44 
@ Nickname: insert-emoji 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_PASTE_AS_PLAIN_TEXT 


Paste clipboard contents as plain text. Since 2.30 


@ Value: 45 
@ Nickname: paste-as-plain-text 
e@ Available since: 4.1 


WEBKIT_CONTEXT_MENU_ACTION_CUSTOM 


Custom action defined by applications. 


@ Value: 10000 
@ Nickname: custom 
e@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

CookieAcceptPolic 

Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2CookieAcceptPolicy 


unstable since: 4.1 


Declaration 


enum WebKit2.CookieAcceptPolicy 


Description 


Enum values used to denote the cookie acceptance policies. 


Available since: 4.1 


Members 


WEBKIT_COOKIE_POLICY_ACCEPT_ALWAYS 


Accept all cookies unconditionally. 


@ Value: 0 
@ Nickname: always 
@ Available since: 4.1 


WEBKIT_COOKIE_POLICY_ACCEPT_NEVER 


Reject all cookies unconditionally. 


@ Value: 1 
@ Nickname: never 
@ Available since: 4.1 


WEBKIT_COOKIE_POLICY_ACCEPT_NO_THIRD_PARTY 


Accept only cookies set by the main document loaded. 


@ Value: 2 
@ Nickname: no-third-party 
e@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

CookiePersistentStorage 
Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2;CookiePersistentStorage 


unstable since: 4.1 


Declaration 


enum WebKit2.CookiePersistentStorage 


Description 


Enum values used to denote the cookie persistent storage types. 


Available since: 4.1 


Members 


WEBKIT_COOKIE_PERSISTENT_STORAGE_TEXT 


Cookies are stored in a text file in the Mozilla “cookies.txt” format. 


@ Value: 0 
@ Nickname: text 
@ Available since: 4.1 


WEBKIT_COOKIE_PERSISTENT_STORAGE_SQLITE 


Cookies are stored in a SQLite file in the current Mozilla format. 


@ Value: 1 
@ Nickname: sqlite 
@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
CredentialPersistence 


Generated by[gi-docgen|2023.3 


Enumeration 


W ebKit2\;CredentialPersistence 


since: 2.2 


Declaration 


enum WebKit2.CredentialPersistenc 


Description 


Enum values representing the duration for which a credential persists. 


Available since: 2.2 


Members 


WEBKIT CREDENTIAL PERSISTENCE_NONE 


Credential does not persist. 


@ Value: 0 
@ Nickname: none 
@ Available since: 2.2 


WEBKIT_CREDENTIAL_PERSISTENCE_FOR_SESSION 


Credential persists for session only. 


@ Value: 1 
@e Nickname: for-session 
@ Available since: 2.2 


WEBKIT CREDENTIAL PERSISTENCE PERMANENT 


Credential persists permanently. 


@ Value: 2 
@ Nickname: permanent 
e@ Available since: 2.2 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2FeatureStatus 


since: 2.42 


Declaration 


enum WebKit2.FeatureStatus 


Description |[src] 
Describes the status of alWebKitFeature 
The status for a given feature can be obtained withwebkit_feature_get_status() 


Available since: 2.42 


Members 


WEBKIT FEATURE _STATUS_EMBEDDER 


Feature that adjust behaviour for specific application needs. The feature is not part of a Web platform 
feature, not a mature feature intended to be always on. 


@ Value: 0 
@ Nickname: embedder 
e@ Available since: 2.42 


WEBKIT_FEATURE_STATUS_UNSTABLE 


Feature in development. The feature may be unfinished, and there are no guarantees about its safety 
and stability. 


@ Value: 1 
@ Nickname: unstable 
@ Available since: 2.42 


Feature for debugging the WebKit engine. The feature is not generally useful for user or web 
developers, and always disabled by default. 


@ Value: 2 
@ Nickname: internal 
@ Available since: 2.42 


Feature for web developers. The feature is not generally useful for end users, and always disabled 
by default. 


@ Value: 3 
@ Nickname: developer 
@ Available since: 2.42 


Feature in active development and complete enough for testing. The feature may not be yet ready to 
ship and is disabled by default. 


@ Value: 4 
@ Nickname: testable 
@ Available since: 2.42 


Feature ready to be tested by users. The feature is disabled by default, but may be enabled by 
applications automatically e.g. in their Atechnology previewé or abetaa versions. 


@ Value: 5 
@ Nickname: preview 
@ Available since: 2.42 


Feature ready for general use. The feature is enabled by default, but it may still be toggled to support 
debugging and testing. 


@ Value: 6 
@ Nickname: stable 
@ Available since: 2.42 


Feature in general use. The feature is always enabled and in general there should be no user-facing 
interface to toggle it. 


@ Value: 7 
@ Nickname: mature 
e@ Available since: 2.42 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 
HardwareAccelerationPolic 
Generated by 2023.3 


Enumeration 


WebKit2HardwareAccelerationPolicy 


since: 2.16 


Declaration 


enum WebKit2.HardwareAccelerationPolicy 


Description 


Enum values used for determining the hardware acceleration policy. 


Available since: 2.16 


Members 


WEBKIT HARDWARE _ACCELERATION_POLICY_ON_DEMAND 


Hardware acceleration is enabled/disabled as request by web contents. 


e@ Value: 0 
@ Nickname: on-demand 
@ Available since: 2.16 


WEBKIT HARDWARE _ACCELERATION_POLICY_ALWAYS 


Hardware acceleration is always enabled, even for websites not requesting it. 


@ Value: 1 
@ Nickname: always 
@ Available since: 2.16 


WEBKIT HARDWARE ACCELERATION_POLICY_NEVER 


Hardware acceleration is always disabled, even for websites requesting it. 


@ Value: 2 
@ Nickname: never 
e@ Available since: 2.16 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2InputPurpose 


since: 2.28 


Declaration 


enum WebKit2.InputPurpose 


Description 


Enum values used to describe the primary purpose of the active editable element. 


Available since: 2.28 


Members 


WEBKIT_INPUT_PURPOSE_F REE_FORM 


Editable element expects any characters. 


@ Value: 0 
@ Nickname: free-form 
@ Available since: 2.28 


WEBKIT_INPUT_PURPOSE_DIGITS 


Editable element expects digits. 


@ Value: 1 
@ Nickname: digits 
@ Available since: 2.28 


WEBKIT_INPUT_PURPOSE_NUMBER 


Editable element expects a number. 


@ Value: 2 
@ Nickname: number 
e@ Available since: 2.28 


WEBKIT_INPUT_PURPOSE_PHONE 


Editable element expects a telephone. 


@ Value: 3 
@ Nickname: phone 
e@ Available since: 2.28 


WEBKIT_INPUT_PURPOSE_URL 


Editable element expects a URL. 


@ Value: 4 
@ Nickname: url 
e@ Available since: 2.28 


WEBKIT_INPUT_PURPOSE_EMAIL 


Editable element expects an email. 


@ Value: 5 
@ Nickname: email 
e@ Available since: 2.28 


WEBKIT_INPUT_PURPOSE_PASSWORD 


Editable element expects a password. 


@ Value: 6 
@ Nickname: password 
e@ Available since: 2.28 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
InsecureContentEvent 


Generated by[gi-docgen|2023.3 


Enumeration 


W ebKit2InsecureContentEvent 


unstable since: 4.1 


Declaration 


enum WebKit2.InsecureContentEvent 


Description 


Enum values used to denote the different events which can trigger the detection of insecure content. 


Available since: 4.1 


Members 


WEBKIT_INSECURE_CONTENT_RUN 


Insecure content has been detected by trying to execute any kind of logic (e.g. a script) from an 
untrusted source. 


@ Value: 0 
@ Nickname: run 
@ Available since: 4.1 


WEBKIT_INSECURE_CONTENT_DISPLAYED 


Insecure content has been detected by trying to display any kind of resource (e.g. an image) from an 
untrusted source. 


@ Value: 1 
@ Nickname: displayed 
e@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Generated by[gi-docgen|2023.3 


Enumeration 


W ebKit2\_oadEvent 


unstable since: 4.1 


Declaration 


enum WebKit2.LoadEvent 


Description 


Enum values used to denote the different events that happen during a WebKitWebView load operation. 


Available since: 4.1 


Members 


WEBKIT LOAD STARTED 


A new load request has been made. No data has been received yet, empty structures have been 
allocated to perform the load; the load may still fail due to transport issues such as not being able to 
resolve a name, or connect to a port. 


@ Value: 0 
@ Nickname: started 
@ Available since: 4.1 


WEBKIT LOAD REDIRECTED 


A provisional data source received a server redirect. 


@ Value: 1 
@ Nickname: redirected 
e@ Available since: 4.1 


WEBKIT LOAD COMMITTED 


The content started arriving for a page load. The necessary transport requirements are established, 
and the load is being performed. 


@ Value: 2 
@ Nickname: committed 
e@ Available since: 4.1 


WEBKIT LOAD FINISHED 


Load completed. All resources are done loading or there was an error during the load operation. 


@ Value: 3 
@ Nickname: finished 
e@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

MediaCaptureS tate 

Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2MediaCaptureState 


since: 2.34 


Declaration 


enum WebKit2.MediaCaptureState 


Description 


Enum values used to specify the capture state of a media device. 


Available since: 2.34 


Members 


WEBKIT MEDIA CAPTURE_STATE_NONE 


Media capture is disabled. 


@ Value: 0 
@ Nickname: none 
@ Available since: 2.34 


WEBKIT MEDIA CAPTURE_STATE_ACTIVE 


Media capture is active. 


@ Value: 1 
@ Nickname: active 
@ Available since: 2.34 


WEBKIT MEDIA CAPTURE _STATE_ MUTED 


Media capture is muted. 


@ Value: 2 
@ Nickname: muted 
e@ Available since: 2.34 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2NavigationType 


unstable since: 4.1 


Declaration 


enum WebKit2.NavigationType 


Description 


Enum values used to denote the various navigation types. 


Available since: 4.1 


Members 


WEBKIT NAVIGATION_TYPE_LINK_CLICKED 


The navigation was triggered by clicking a link. 


@ Value: 0 
@e Nickname: link-clicked 
@ Available since: 4.1 


WEBKIT NAVIGATION_TYPE_FORM_ SUBMITTED 


The navigation was triggered by submitting a form. 


@ Value: 1 
@e Nickname: form-submitted 
@ Available since: 4.1 


WEBKIT NAVIGATION _TYPE BACK FORWARD 


The navigation was triggered by navigating forward or backward. 


@ Value: 2 
@ Nickname: back-forward 
e@ Available since: 4.1 


WEBKIT NAVIGATION_TYPE_ RELOAD 


The navigation was triggered by reloading. 


@ Value: 3 
@ Nickname: reload 
e@ Available since: 4.1 


WEBKIT NAVIGATION _TYPE_ FORM RESUBMITTED 


The navigation was triggered by resubmitting a form. 


@ Value: 4 
@ Nickname: form-resubmitted 
e@ Available since: 4.1 


WEBKIT NAVIGATION_TYPE OTHER 


The navigation was triggered by some other action. 


@ Value: 5 
@ Nickname: other 
e@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
INetworkProxyMode 


Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2NetworkProxyMode 


since: 2.16 


Declaration 


enum WebKit2.NetworkProxyMode 


Description 


Enum values used to set the network proxy mode. 


Available since: 2.16 


Members 


WEBKIT _NETWORK_PROXY_MODE_DEFAULT 


Use the default proxy of the system. 


@ Value: 0 
@ Nickname: default 
@ Available since: 2.16 


WEBKIT_NETWORK_PROXY_MODE_NO_PROXY 


Do not use any proxy. 


@ Value: 1 
@® Nickname: no-proxy 
@ Available since: 2.16 


WEBKIT_NETWORK_PROXY_MODE_CUSTOM 


Use custom proxy settings. 


@ Value: 2 
@ Nickname: custom 
e@ Available since: 2.16 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Generated by[gi-docgen|2023.3 


Enumeration 


W ebKit2/PermissionState 


since: 2.40 


Declaration 


enum WebKit2.PermissionState 


Description 


Enum values representing query permission results. 


Available since: 2.40 


Members 


WEBKIT_PERMISSION_STATE_GRANTED 


Access to the feature is granted. 


@ Value: 0 
@ Nickname: granted 
@ Available since: 2.40 


Access to the feature is denied. 


@ Value: 1 
e Nickname: denied 
@ Available since: 2.40 


WEBKIT_PERMISSION_STATE_PROMPT 


Access to the feature has to be requested via user prompt. 


@ Value: 2 
@ Nickname: prompt 
e@ Available since: 2.40 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
PolicyDecisionType 


Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2PolicyDecisionType 


unstable since: 4.1 


Declaration 


enum WebKit2.PolicyDecisionType 


Description 


Enum values used for determining the type of a policy decision during 
WebKitWebView: :decide-policy. 


Available since: 4.1 


Members 


WEBKIT_POLICY_DECISION_TYPE_NAVIGATION_ACTION 


This type of policy decision is requested when WebKit is about to navigate to a new page in either 
the main frame or a subframe. Acceptable policy decisions are either 
webkit_policy_decision_use() or webkit_policy_decision_ignore(). This type of policy 
decision is always a WebKitNavigationPolicyDecision. 


@ Value: 0 
@ Nickname: navigation-action 
@ Available since: 4.1 


WEBKIT_POLICY_DECISION_TYPE_NEW_WINDOW_ACTION 


This type of policy decision is requested when WebKit is about to create a new window. Acceptable 
policy decisions are either webkit_policy_decision_use() or 
webkit_policy_decision_ignore(). This type of policy decision is always a 
WebKitNavigationPolicyDecision. These decisions are useful for implementing special 
actions for new windows, such as forcing the new window to open in a tab when a keyboard modifier is 
active or handling a special target attribute on elements. 


@ Value: 1 
@ Nickname: new-window-action 
e@ Available since: 4.1 


WEBKIT_POLICY_DECISION_TYPE_RESPONSE 


This type of decision is used when WebKit has received a response for a network resource and is 
about to start the load. Note that these resources include all subresources of a page such as images 
and stylesheets as well as main documents. Appropriate policy responses to this decision are 
webkit_policy_decision_use(), webkit_policy_decision_ignore(), or 
webkit_policy_decision_download(). This type of policy decision is always a 
WebKitResponsePolicyDecision. This decision is useful for forcing some types of resources 
to be downloaded rather than rendered in the WebView or to block the transfer of resources entirely. 


@ Value: 2 
@ Nickname: response 
e@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2PrintOperationResponse 


unstable since: 4.1 


Declaration 


enum WebKit2.PrintOperationResponse 


Description 


Enum values representing the response of the print dialog shown 
with webkit_print_operation_run_dialog(). 


Available since: 4.1 


Members 


WEBKIT _PRINT_OPERATION_RESPONSE_PRINT 


Print button was clicked in print dialog. 


@ Value: 0 
@ Nickname: print 
@ Available since: 4.1 


WEBKIT_PRINT_OPERATION_RESPONSE_CANCEL 


Print dialog was cancelled. 


@ Value: 1 
@ Nickname: cancel 
@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


ProcessModel 
Generated by[gi-docgen|2023.3 


Enumeration 


W ebKit2ProcessModel 


deprecated: 2.40 since: 2.4 


Declaration 


enum WebKit2.ProcessModel 


Description 


Enum values used for determining the WebKitWebContext process model. 
Available since: 2.4 
Deprecated since: 2.40 
Please do not use it in newly written code. 
Members 
Deprecated 2.26. 


@ Value: 0 
@ Nickname: shared-secondary-process 
@ Available since: 2.4 


WEBKIT_PROCESS_MODEL_MULTIPLE_SKCONDARY_PROCESSES 


Use one process for each WebKitWebView, while still allowing for some of them to share a process 
in certain situations. The main advantage of this process model is that the rendering process for a web 
view can crash while the rest of the views keep working normally. This process model is indicated for 
applications which may use a number of web views and the content of in each must not interfere with the 
rest 4 for example a full-fledged web browser with support for multiple tabs. 


@ Value: 1 


@ Nickname: multiple-secondary-processes 
@ Available since: 2.4 


Content 


Description 
Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2SaveMode 


unstable since: 4.1 


Declaration 


enum WebKit2.SaveMode 


Description 


Enum values to specify the different ways in which a WebKitWebView can save its current web page 
into a self-contained file. 


Available since: 4.1 


Members 


WEBKIT SAVE _MODE_MHTML 


Save the current page using the MHTML format. 


@ Value: 0 
@ Nickname: mhtml 
@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

ScriptDialogType 

Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2ScriptDialogType 


unstable since: 4.1 


Declaration 


enum WebKit2.ScriptDialogType 


Description 


Enum values used for determining the type of WebKit ScriptDialog. 


Available since: 4.1 


Members 


WEBKIT_SCRIPT_DIALOG_ALERT 


Alert script dialog, used to show a message to the user. 


@ Value: 0 
@ Nickname: alert 
@ Available since: 4.1 


WEBKIT_SCRIPT_DIALOG_CONFIRM 


Confirm script dialog, used to ask confirmation to the user. 


@ Value: 1 
@ Nickname: confirm 
@ Available since: 4.1 


WEBKIT_SCRIPT_DIALOG_PROMPT 


Prompt script dialog, used to ask information to the user. 


@ Value: 2 
@ Nickname: prompt 
e@ Available since: 4.1 


WEBKIT_SCRIPT_DIALOG_BEFORE_UNLOAD_CONF IRM 


Before unload confirm dialog, used to ask confirmation to leave the current page to the user. 
Since 2.12 


@ Value: 3 
@ Nickname: before-unload-confirm 
e@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2SnapshotRegion 


unstable since: 4.1 


Declaration 


enum WebKit2.SnapshotRegion 


Description 


Enum values used to specify the region from which to get a WebKitWebView snapshot. 


Available since: 4.1 


Members 


WEBKIT_SNAPSHOT_REGION_VISIBLE 


Specifies a snapshot only for the area that is visible in the webview. 


@ Value: 0 
@e Nickname: visible 
@ Available since: 4.1 


WEBKIT_SNAPSHOT_REGION_FULL_DOCUMENT 


A snapshot of the entire document. 


@ Value: 1 
@ Nickname: full-document 
@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
TLSErrorsPolic 


Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2/TLSErrorsPolicy 


unstable since: 4.1 


Declaration 


enum WebKit2.TLSErrorsPolicy 


Description 


Enum values used to denote the TLS errors policy. 


Available since: 4.1 


Members 


WEBKIT_TLS_ERRORS_POLICY_IGNORE 


Ignore TLS errors. 


@ Value: 0 
@ Nickname: ignore 
@ Available since: 4.1 


WEBKIT_TLS_ERRORS_POLICY_FAIL 


TLS errors will emit WebKitWebView: :load-failed-with-tls-—errors and, if the signal 
is handled, finish the load. In case the signal is not handled, WebKitWebView: : load-failed is 
emitted before the load finishes. 


@ Value: 1 
@ Nickname: fail 
e@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
UserContentInjectedFrames 


Generated by 2023.3 


Enumeration 


WebKit2UserContentInjectedFrames 


since: 2.6 


Declaration 


enum WebKit2.UserContentInjectedFrames 


Description 


Specifies in which frames user style sheets are to be inserted in. 


Available since: 2.6 


Members 


WEBKIT_USER_CONTENT_INJECT_ALL_FRAMES 


Insert the user style sheet in all the frames loaded by the web view, including nested frames. This is 
the default. 


@ Value: 0 
@ Nickname: all-—frames 
@ Available since: 2.6 


WEBKIT_USER_CONTENT_INJECT_TOP_FRAME 


Insert the user style sheet only in the top-level frame loaded by the web view, and not in the 
nested frames. 


@ Value: 1 
@ Nickname: top-frame 
e@ Available since: 2.6 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 
UserScriptInjectionTime 
Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2UserScriptInjectionTime 


since: 2.6 


Declaration 


enum WebKit2.UserScriptInjectionTime 


Description 


Specifies at which place of documents an user script will be inserted. 


Available since: 2.6 


Members 


WEBKIT_USER_SCRIPT_INJECT_AT_DOCUMENT_START 


Insert the code of the user script at the beginning of loaded documents. This is the default. 


@ Value: 0 
@ Nickname: start 
@ Available since: 2.6 


WEBKIT_USER_SCRIPT_INJECT_AT_DOCUMENT_END 


Insert the code of the user script at the end of the loaded documents. 


@ Value: 1 
@ Nickname: end 
@ Available since: 2.6 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

UserStyleLevel 

Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2UserStyleLevel 


since: 2.6 


Declaration 


enum WebKit2.UserStyleLevel 


Description 


Specifies how to treat an user style sheet. 


Available since: 2.6 


Members 


WEBKIT_USER_STYLE_LEVEL_USER 


The style sheet is an user style sheet, its contents always override other style sheets. This is 
the default. 


@ Value: 0 
@ Nickname: user 
@ Available since: 2.6 


WEBKIT_USER_STYLE_LEVEL_AUTHOR 


The style sheet will be treated as if it was provided by the loaded documents. That means other user 
style sheets may still override it. 


@ Value: 1 
@ Nickname: author 
e@ Available since: 2.6 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
W ebExtensionMode 


Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2\WebExtensionMode 


since: 2.38 


Declaration 


enum WebKit2.WebExtensionMode 


Description 


Enum values used for setting if a WebKitWebView is intended for WebExtensions. 


Available since: 2.38 


Members 


WEBKIT WEB _EXTENSION_MODE_NONE 


Not for an extension. 


@ Value: 0 
@ Nickname: none 
@ Available since: 2.38 


WEBKIT WEB _ EXTENSION _MODE_MANIFESTV2 


For a ManifestV2 extension. 


@ Value: 1 
@ Nickname: manifestv2 
@ Available since: 2.38 


WEBKIT WEB EXTENSION MODE MANIFESTV3 


For a ManifestV3 extension. 


@ Value: 2 
@ Nickname: manifestv3 
e@ Available since: 2.38 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 
WebProcessTerminationReason 
Generated by 2023.3 


Enumeration 


WebKit2\WebProcessTerminationReason 


since: 2.20 


Declaration 


enum WebKit2.WebProcessTerminationReason 


Description 


Enum values used to specify the reason why the web process terminated abnormally. 


Available since: 2.20 


Members 


WEBKIT_WEB_PROCESS_CRASHED 


The web process crashed. 


@ Value: 0 
@ Nickname: crashed 
@ Available since: 2.20 


The web process exceeded the memory limit. 


@ Value: 1 
@ Nickname: exceeded-memory-limit 
@ Available since: 2.20 


WEBKIT WEB PROCESS _ TERMINATED _BY_APT 


The web process termination was requested by an API call. Since: 2.34 


@ Value: 2 
@ Nickname: terminated-by-api 
e@ Available since: 2.20 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
EditorTyping Attributes 


Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2EditorTypingAttributes 


since: 2.10 


Declaration 


flags WebKit2.EditorTypingAttributes 


Description 


Enum values with flags representing typing attributes. 


Available since: 2.10 


Members 


WEBKIT_EDITOR_TYPING_ATTRIBUTE_NONE 


No typing attributes. 


@ Value: 2 
@ Nickname: none 
@ Available since: 2.10 


WEBKIT_EDITOR_TYPING_ATTRIBUTE_BOLD 


Bold typing attribute. 


@ Value: 4 
@ Nickname: bold 
@ Available since: 2.10 


WEBKIT EDITOR_TYPING ATTRIBUTE _ ITALIC 


Italic typing attribute. 


@ Value: 8 
@ Nickname: italic 
e@ Available since: 2.10 


WEBKIT_ EDITOR_TYPING_ ATTRIBUTE UNDERLINE 


Underline typing attribute. 


@ Value: 16 
@ Nickname: underline 
e@ Available since: 2.10 


WEBKIT_EDITOR_TYPING_ATTRIBUTE_STRIKETHROUGH 


Strikethrough typing attribute. 


@ Value: 32 
@ Nickname: strikethrough 
e@ Available since: 2.10 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2FindOptions 


unstable since: 4.1 


Declaration 


flags WebKit2.FindOptions 


Description 


Enum values used to specify search options. 


Available since: 4.1 


Members 


WEBKIT_FIND_OPTIONS_NONE 


No search flags, this means a case sensitive, no wrap, forward only search. 


@ Value: 0 
@ Nickname: none 
@ Available since: 4.1 


WEBKIT_FIND_OPTIONS_CASE_INSENSITIVE 


Case insensitive search. 


@ Value: 1 
e Nickname: case-insensitive 
@ Available since: 4.1 


WEBKIT_FIND_OPTIONS_AT_WORD_STARTS 


Search text only at the begining of the words. 


@ Value: 2 
@ Nickname: at-word-starts 
e@ Available since: 4.1 


WEBKIT FIND OPTIONS _ TREAT MEDIAL CAPITAL AS WORD_START 


Treat capital letters in the middle of words as word start. 


@ Value: 4 
@ Nickname: treat-medial-capital-as-—word-start 
@ Available since: 4.1 


WEBKIT_FIND_OPTIONS_BACKWARDS 


Search backwards. 


@ Value: 8 
@ Nickname: backwards 
e@ Available since: 4.1 


WEBKIT_FIND_OPTIONS_WRAP_AROUND 


If not present search will stop at the end of the document. 


@ Value: 16 
@ Nickname: wrap-around 
e@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

HitTestResultContext 
Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2HitTestResultContext 


unstable since: 4.1 


Declaration 


flags WebKit2.HitTestResultContext 


Description |[src] 
Enum values with flags representing the context of aWebKitHitTestResult. 


Available since: 4.1 


Members 


WEBKIT_HIT_TEST_RESULT_CONTEXT_DOCUMENT 


Anywhere in the document. 


@ Value: 2 
@ Nickname: document 
@ Available since: 4.1 


WEBKIT_ HIT TEST RESULT_CONTEXT_LINK 
A hyperlink element. 


@ Value: 4 
@ Nickname: link 
@ Available since: 4.1 


WEBKIT_HIT_TEST_RESULT_CONTEXT_IMAGE 


An image element. 


@ Value: 8 
@ Nickname: image 
e@ Available since: 4.1 


WEBKIT HIT TEST RESULT CONTEXT MEDIA 


A video or audio element. 


@ Value: 16 
@ Nickname: media 
e@ Available since: 4.1 


WEBKIT HIT TEST RESULT CONTEXT _EDITABLE 


An editable element. 


@ Value: 32 
@ Nickname: editable 
e@ Available since: 4.1 


WEBKIT_HIT_TEST_RESULT_CONTEXT_SCROLLBAR 


A scrollbar element. 


@ Value: 64 
@ Nickname: scrollbar 
e@ Available since: 4.1 


WEBKIT_HIT_TEST_RESULT_CONTEXT_SELECTION 


A selected element. Since 2.8 


@ Value: 128 
@ Nickname: selection 
@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2InputHints 


since: 2.28 


Declaration 


flags WebKit2.InputHints 


Description 


Enum values used to describe hints that might be taken into account by input methods. 


Available since: 2.28 


Members 


WEBKIT_INPUT_HINT_NONE 


No special behavior suggested. 


@ Value: 0 
@ Nickname: none 
@ Available since: 2.28 


WEBKIT_INPUT_HINT_SPELLCHECK 
Suggest spell checking. 


@ Value: 1 
@ Nickname: spellcheck 
e@ Available since: 2.28 


WEBKIT INPUT _HINT_ LOWERCASE 


Suggest to not autocapitlize. 


@ Value: 2 
@ Nickname: lowercase 
e@ Available since: 2.28 


WEBKIT_INPUT_HINT_UPPERCASE_CHARS 


Suggest to capitalize all text. 


@ Value: 4 
@ Nickname: uppercase-chars 
@ Available since: 2.28 


WEBKIT_INPUT_HINT_UPPERCASE_WORDS 


Suggest to capitalize the first character of each word. 


@ Value: 8 
@ Nickname: uppercase-words 
@ Available since: 2.28 


WEBKIT_INPUT_HINT_UPPERCASE_SENTENCES 


Suggest to capitalize the first word of each sentence. 


@ Value: 16 
@ Nickname: uppercase-sentences 
e@ Available since: 2.28 


WEBKIT INPUT _HINT_ INHIBIT _OSK 


Suggest to not show an onscreen keyboard. 


@ Value: 32 
@ Nickname: inhibit-osk 
e@ Available since: 2.28 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 
Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2SnapshotOptions 


unstable since: 4.1 


Declaration 


flags WebKit2.SnapshotOptions 


Description 


Enum values used to specify options when taking a snapshot from a WebKitWebView. 


Available since: 4.1 


Members 


WEBKIT_SNAPSHOT_OPTIONS_NONE 


Do not include any special options. 


@ Value: 0 
@ Nickname: none 
@ Available since: 4.1 


WEBKIT_SNAPSHOT_OPTIONS_INCLUDE_SELECTION_HIGHLIGHTING 


Whether to include in the snapshot the highlight of the selected content. 


@ Value: 1 
@ Nickname: include-selection-highlighting 
@ Available since: 4.1 


WEBKIT_SNAPSHOT_OPTIONS_TRANSPARENT_BACKGROUND 


Do not fill the background with white before rendering the snapshot. Since 2.8 


@ Value: 2 
@ Nickname: transparent-—background 
@ Available since: 4.1 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 

Type 

WebsiteDataTypes 

Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2/WebsiteDataTypes 


since: 2.16 


Declaration 


flags WebKit2.WebsiteDataTypes 


Description 


Enum values with flags representing types of Website data. 


Available since: 2.16 


Members 


WEBKIT WEBSITE DATA MEMORY_CACHE 


Memory cache. 


@ Value: 1 
@ Nickname: memory-cache 
@ Available since: 2.16 


WEBKIT WEBSITE DATA DISK_CACHE 


HTTP disk cache. 


@ Value: 2 
@ Nickname: disk-cache 
@ Available since: 2.16 


WEBKIT WEBSITE DATA OFFLINE APPLICATION CACHE 


Offline web application cache. 


@ Value: 4 
@ Nickname: of fline-application-cache 
@ Available since: 2.16 


WEBKIT_WEBSITE_DATA_SESSION_STORAGE 


Session storage data. 


@ Value: 8 
@ Nickname: session-storage 
@ Available since: 2.16 


WEBKIT_WEBSITE_DATA_LOCAL_STORAGE 


Local storage data. 


@ Value: 16 
@ Nickname: local-storage 
e@ Available since: 2.16 


WEBKIT WEBSITE DATA WEBSOQL_ DATABASES 
WebSQL databases. Deprecated 2.24 


@ Value: 32 
@ Nickname: websql-—databases 
e@ Available since: 2.16 


WEBKIT WEBSITE DATA INDEXEDDB_ DATABASES 


IndexedDB databases. 


@ Value: 64 
@ Nickname: indexeddb-databases 
e@ Available since: 2.16 


WEBKIT WEBSITE DATA PLUGIN_DATA 


Plugins data. Deprecated 2.32 


@ Value: 128 
@ Nickname: plugin-data 
e@ Available since: 2.16 


WEBKIT_WEBSITE_DATA_COOKIES 


Cookies. 


@ Value: 256 
@ Nickname: cookies 
e Available since: 2.16 


WEBKIT WEBSITE DATA DEVICE _ID_HASH SALT 


Hash salt used to generate the device ids used by webpages. Since 2.24 


@ Value: 512 
@ Nickname: device-id-hash-salt 
e@ Available since: 2.16 


WEBKIT WEBSITE DATA _HSTS_CACHE 
HSTS cache. Since 2.26 


@ Value: 1024 

@ Nickname: hsts-cache 

e@ Available since: 2.16 
WEBKIT_ WEBSITE DATA ITP 


Intelligent Tracking Prevention data. Since 2.30. 


@ Value: 2048 
@ Nickname: itp 
e Available since: 2.16 


WEBKIT_WEBSITE_DATA_SERVICE_WORKER_REGISTRATIONS 


Service worker registrations. Since 2.30 


@ Value: 4096 
@ Nickname: service-worker-registrations 
@ Available since: 2.16 


DOM (CacheStorage) cache. Since 2.30 


@ Value: 8192 
@ Nickname: dom-—cache 
@ Available since: 2.16 


WEBKIT WEBSITE DATA ALL 
All types. 


@ Value: 16383 
@ Nickname: all 
@ Available since: 2.16 


Content 


@ |Description 
@ |Members 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
(DownloadError 


Type functions 


Generated by[gi-docgen|2023.3 


Enumeration 


W ebKit2IDownloadError 


unstable since: 4.1 


Declaration 


error-domain WebKit2.DownloadError 


Description 


Enum values used to denote the various download errors. 


Available since: 4.1 


Members 


WEBKIT DOWNLOAD _ERROR_NETWORK 


Download failure due to network error. 


@ Value: 499 
@ Nickname: network 
e@ Available since: 4.1 


WEBKIT_DOWNLOAD_ERROR_CANCELLED_BY_USER 


Download was cancelled by user. 


@ Value: 400 
@ Nickname: cancelled-by-user 
e@ Available since: 4.1 


WEBKIT DOWNLOAD _ERROR_DESTINATION 


Download failure due to destination error. 


@ Value: 401 
@ Nickname: destination 
e@ Available since: 4.1 


Type functions 
Gets the quark for the domain of download errors. 
unstable since: 4.1 


Content 


@ |Description 
@ |Members 
@ (Functions 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
DownloadError 


Functions 


Generated by[gi-docgen|2023.3 


Function 


WebKit2DownloadErrorquark 


Declaration 


GQuark 
webkit_download_error_quark ( 
void 


) 


Description 


Gets the quark for the domain of download errors. 
Return value 
Type: GQuark 


Download error domain. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
FaviconDatabaseError| 


Type functions 


Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2FaviconDatabaseError 


unstable since: 4.1 


Declaration 


error-domain WebKit2.FaviconDatabaseError 


Description 


Enum values used to denote the various errors related to the WebKitFaviconDatabase. 


Available since: 4.1 


Members 


WEBKIT FAVICON DATABASE _ERROR_NOT_INITIALIZED 


The WebKitFaviconDatabase is closed. 


@ Value: 0 
@ Nickname: not-initialized 
@ Available since: 4.1 


WEBKIT_FAVICON_DATABASE_ERROR_FAVICON_NOT_FOUND 


There is not an icon available for the requested URL. 


@ Value: 1 
@ Nickname: favicon-not-found 
e@ Available since: 4.1 


WEBKIT_FAVICON_DATABASE_ERROR_FAVICON_UNKNOWN 


There might be an icon for the requested URL, but its data is unknown at the moment. 


@ Value: 2 
@ Nickname: favicon-unknown 
e@ Available since: 4.1 


Type functions 
Gets the quark for the domain of favicon database errors. 
unstable since: 4.1 


Content 


@ |Description 
@ |Members 
e 


Functions 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Functions 
Generated by[gi-docgen|2023.3 
Function 
WebKit2FaviconDatabaseErrorquark 
Declaration 
GQuark 
webkit_favicon_database_error_quark ( 
void 


) 


Description 


Gets the quark for the domain of favicon database errors. 
Return value 
Type: GQuark 


Favicon database error domain. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Type functions 


Generated by[gi-docgen]2023.3 


Enumeration 


WebKit2JavascriptError 


unstable since: 4.1 


Declaration 


error-domain WebKit2.JavascriptError 


Description 


Enum values used to denote errors happening when executing JavaScript. 


Available since: 4.1 


Members 


WEBKIT_JAVASCRIPT_ERROR_SCRIPT_FAILED 


An exception was raised in JavaScript execution. 


@ Value: 699 
@ Nickname: script-failed 
e@ Available since: 4.1 


WEBKIT JAVASCRIPT _ERROR_INVALID_PARAMETER 


An unsupported parameter has been used to call and async function from API. Since 2.40 


@ Value: 600 
@ Nickname: invalid-parameter 
e@ Available since: 4.1 


WEBKIT_JAVASCRIPT_ERROR_INVALID_RESULT 


The result of JavaScript execution could not be returned. Since 2.40 


@ Value: 601 
@ Nickname: invalid-result 
e@ Available since: 4.1 


Type functions 
Gets the quark for the domain of JavaScript errors. 
unstable since: 4.1 


Content 


@ |Description 
@ |Members 
@ (Functions 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Functions 


Generated by[gi-docgen|2023.3 


Function 


WebKitdJavascriptErrorquark 


Declaration 


GQuark 
webkit_javascript_error_quark ( 
void 


) 


Description 


Gets the quark for the domain of JavaScript errors. 
Return value 
Type: GQuark 


JavaScript error domain. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Type 


Type functions 


Generated by[gi-docgen]2023.3 


Enumeration 


WebKit2NetworkError 


unstable since: 4.1 


Declaration 


error-domain WebKit2.NetworkError 


Description 


Enum values used to denote the various network errors. 


Available since: 4.1 


Members 


WEBKIT NETWORK_ERROR_FATLED 


Generic load failure. 


@ Value: 399 
@e Nickname: failed 
e@ Available since: 4.1 


WEBKIT NETWORK_ERROR_TRANSPORT 


Load failure due to transport error. 


@ Value: 300 
@ Nickname: transport 
e@ Available since: 4.1 


WEBKIT_NETWORK_ERROR_UNKNOWN_PROTOCOL 


Load failure due to unknown protocol. 


@ Value: 301 
@ Nickname: unknown-protocol 
e@ Available since: 4.1 


WEBKIT NETWORK_ERROR_CANCELLED 


Load failure due to cancellation. 


@ Value: 302 
@ Nickname: cancelled 
e@ Available since: 4.1 


WEBKIT_NETWORK_ERROR_FILE_DOES_NOT_EXIST 


Load failure due to missing file. 


@ Value: 303 
@ Nickname: file-does-not-exist 
e@ Available since: 4.1 


Type functions 
Gets the quark for the domain of networking errors. 
unstable since: 4.1 


Content 


@ |Description 
@ |Members 
e 


Functions 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Functions 


Generated by[gi-docgen|2023.3 


Function 


WebKit2NetworkErrorquark 


Declaration 


GQuark 
webkit_network_error_quark ( 
void 


) 


Description 


Gets the quark for the domain of networking errors. 
Return value 
Type: GQuark 


Network error domain. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Type functions 


Generated by[gi-docgen]2023.3 


Enumeration 


WebKit2PluginError 


unstable since: 4.1 


Declaration 


error-domain WebKit2.PluginError 


Description 


Enum values used to denote the various plugin and media errors. 


Available since: 4.1 


Members 


WEBKIT PLUGIN_ERROR_FAILED 


Generic plugin load failure. Deprecated 2.32 


@ Value: 299 
@ Nickname: failed 
e@ Available since: 4.1 


WEBKIT_PLUGIN_ERROR_CANNOT_FIND_PLUGIN 


Load failure due to missing plugin. Deprecated 2.32 


@ Value: 200 
@ Nickname: cannot-find-plugin 
e@ Available since: 4.1 


WEBKIT_PLUGIN_ERROR_CANNOT_LOAD_PLUGIN 


Load failure due to inability to load plugin. Deprecated 2.32 


@ Value: 201 
@ Nickname: cannot-load-plugin 
@ Available since: 4.1 


WEBKIT PLUGIN _ERROR_JAVA_UNAVAILABLE 


Load failure due to missing Java support that is required to load plugin. Deprecated 2.32 


@ Value: 202 
@ Nickname: java-unavailable 
e@ Available since: 4.1 


WEBKIT_PLUGIN_ERROR_CONNECTION_CANCELLED 


Load failure due to connection cancellation. Deprecated 2.32 


@ Value: 203 
@ Nickname: connection-cancelled 
@ Available since: 4.1 


WEBKIT PLUGIN _ERROR_ WILL HANDLE LOAD 


Preliminary load failure for media content types. A new load will be started to perform the 
media load. 


@ Value: 204 
@ Nickname: will-handle-load 
e@ Available since: 4.1 


Type functions 
Gets the quark for the domain of plug-in errors. 
unstable since: 4.1 


Content 


@ |Description 
@ |Members 
e 


Functions 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Functions 
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Function 


WebKit2PluginErrorquark 


Declaration 


GQuark 
webkit_plugin_error_quark ( 
void 


) 


Description 


Gets the quark for the domain of plug-in errors. 
Return value 
Type: GQuark 


Plug-in error domain. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Type functions 


Generated by[gi-docgen]2023.3 


Enumeration 


WebKit2PolicyError 


unstable since: 4.1 


Declaration 


error-domain WebKit2.PolicyError 


Description 


Enum values used to denote the various policy errors. 


Available since: 4.1 


Members 


WEBKIT POLICY _ERROR_FAILED 


Generic load failure due to policy error. 


@ Value: 199 
@ Nickname: failed 
e@ Available since: 4.1 


WEBKIT_POLICY_ERROR_CANNOT_SHOW_MIME_TYPE 


Load failure due to unsupported mime type. 


@ Value: 100 
@ Nickname: cannot-show-mime-type 
e@ Available since: 4.1 


WEBKIT_POLICY_ERROR_CANNOT_SHOW_URI 


Load failure due to URI that can not be shown. 


@ Value: 101 
@ Nickname: cannot-show-uri 
@ Available since: 4.1 


WEBKIT_POLICY_ERROR_FRAME_LOAD_INTERRUPTED_BY_POLICY_CHANGE 


Load failure due to frame load interruption by policy change. 


@ Value: 102 
@ Nickname: frame-load-interrupted-by-policy-—change 
e@ Available since: 4.1 


WEBKIT_POLICY_ERROR_CANNOT_USE_RESTRICTED_PORT 


Load failure due to port restriction. 


@ Value: 103 
@ Nickname: cannot-use-restricted-port 
@ Available since: 4.1 


Type functions 
Gets the quark for the domain of policy errors. 
unstable since: 4.1 


Content 


@ |Description 
@ |Members 
e 


Functions 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Functions 
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Function 


WebKit2PolicyErrorquark 


Declaration 


GQuark 
webkit_policy_error_quark ( 
void 


) 


Description 


Gets the quark for the domain of policy errors. 
Return value 
Type: GQuark 


Policy error domain. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Type functions 
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Enumeration 


WebKit2PrintError 


unstable since: 4.1 


Declaration 


error-domain WebKit2.PrintError 


Description 


Enum values used to denote the various print errors. 


Available since: 4.1 


Members 


WEBKIT PRINT _ERROR_GENERAL 


Unspecified error during a print operation. 


@ Value: 599 
@ Nickname: general 
e@ Available since: 4.1 


WEBKIT PRINT _BHRROR_PRINTER_NOT_FOUND 


Selected printer cannot be found. 


@ Value: 500 
@ Nickname: printer-not-—found 
e@ Available since: 4.1 


WEBKIT PRINT _ERROR_INVALID_ PAGE RANGE 


Invalid page range. 


@ Value: 501 
@ Nickname: invalid-page-range 
e@ Available since: 4.1 


Type functions 
Gets the quark for the domain of printing errors. 
unstable since: 4.1 


Content 


@ |Description 
@ |Members 
@ (Functions 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Functions 
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Function 


WebKit2PrintErrorquark 


Declaration 


GQuark 
webkit_print_error_quark ( 
void 


) 


Description 


Gets the quark for the domain of printing errors. 
Return value 
Type: GQuark 


Print error domain. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 


Type functions 
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Enumeration 


WebKit2SnapshotError 


unstable since: 4.1 


Declaration 


error-domain WebKit2.SnapshotError 


Description 


Enum values used to denote errors happening when creating snapshots of WebKitWebView. 


Available since: 4.1 


Members 


WEBKIT_SNAPSHOT_ERROR_FAILED_TO_CREATE 


An error occurred when creating a webpage snapshot. 


@ Value: 799 
@ Nickname: create 
e@ Available since: 4.1 


Type functions 
Gets the quark for the domain of page snapshot errors. 
unstable since: 4.1 


Content 


@ |Description 
@ |Members 
@ (Functions 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 

Functions 

Generated by[gi-docgen|2023.3 

Function 
WebKit2SnapshotErrorquark 
Declaration 


GQuark 
webkit_snapshot_error_quark ( 
void 


) 


Description 


Gets the quark for the domain of page snapshot errors. 
Return value 
Type: GQuark 


Snapshot error domain. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
UserContentFilterError| 


Type functions 


Generated by[gi-docgen|2023.3 


Enumeration 


W ebKit2/UserContentFilterError 


since: 2.24 


Declaration 


error-domain WebKit2.UserContentFilterError 


Description 


Errors that can occur while compiling content filters. 


Available since: 2.24 


Members 


WEBKIT_USER_CONTENT_FILTER_ERROR_INVALID_SOURCE 


The JSON source for a content filter is invalid. 


@ Value: 0 
@ Nickname: invalid-source 
@ Available since: 2.24 


The requested content filter could not be found. 


@ Value: 1 
@ Nickname: not-found 
e@ Available since: 2.24 


Type functions 
Gets the quark for the domain of user content filter errors. 
unstable since: 4.1 


Content 


@ |Description 
@ |Members 
@ (Functions 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Type 
Functions 
Generated by[gi-docgen|2023.3 
Function 
WebKit2UserContentFilterErrorquark 
since: 2.24 
Declaration 
GQuark 
webkit_user_content_filter_error_quark ( 
void 


) 


Description 


Gets the quark for the domain of user content filter errors. 
Available since: 2.24 

Return value 

Type: GQuark 


User content filter error domain. 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Type functions 


Generated by[gi-docgen|2023.3 


Enumeration 


WebKit2UserMessageError 


since: 2.28 


Declaration 


error-domain WebKit2.UserMessageError 


Description 


Enum values used to denote errors happening when sending user messages. 


Available since: 2.28 


Members 


WEBKIT_USER_MESSAGE_UNHANDLED_MESSAGE 


The message was not handled by the receiver. 


@ Value: 0 
@ Nickname: message 
e@ Available since: 2.28 


Type functions 
Gets the quark for the domain of user message errors. 
unstable since: 4.1 


Content 


@ |Description 
@ |Members 
@ (Functions 


| 


WebKit2 

API Version: 4.1 
Library Version: 2.42.4 
Type 


Functions 
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Function 


WebKitqUserMessageErrorquark 


since: 2.28 


Declaration 


GQuark 
webkit_user_message_error_quark ( 
void 


) 


Description 


Gets the quark for the domain of user message errors. 
Available since: 2.28 

Return value 

Type: GQuark 


User message error domain. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Functions 


Generated by[gi-docgen|2023.3 


Function 


WebKit2U RISchemeRequestCallback 


unstable since: 4.1 


Declaration 


void 

(* WebKitURISchemeRequestCallback) ( 
WebKitURISchemeRequest* request, 
gpointer user_data 


) 


Description 


Type definition for a function that will be called back when an URI request is made for a user registered 
URI scheme. 


Available since: 4.1 


Parameters 


request 


Type: |WebKitURISchemeRequest 


The WebKitURISchemeRequest. 


The data is owned by the caller of the function. 


user_data 


Type: gpointer 


User data passed to the callback. 


The argument can be NULL. 


The data is owned by the caller of the function. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Functions 
Generated by[gi-docgen|2023.3 


Function 


WebKit2get_major_version 


unstable since: 4.1 


Declaration 


guint 
webkit_get_major_version ( 
void 


) 


Description 


Returns the major version number of the WebKit library. 
(e.g. in WebKit version 1.8.3 this is 1.) 


This function is in the library, so it represents the WebKit library your code is running against. Contrast 
with the #WEBKIT_MAJOR_VERSION macro, which represents the major version of the WebKit 
headers you have included when compiling your code. 


Available since: 4.1 
Return value 
Type: guint 


The major version number of the WebKit library. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Functions 
Generated by[gi-docgen|2023.3 


Function 


WebKit2eet_micro_version 


unstable since: 4.1 


Declaration 


guint 
webkit_get_micro_version ( 
void 


) 


Description 


Returns the micro version number of the WebKit library. 
(e.g. in WebKit version 1.8.3 this is 3.) 


This function is in the library, so it represents the WebKit library your code is running against. Contrast 
with the #WEBKIT_MICRO_VERSION macro, which represents the micro version of the WebKit 
headers you have included when compiling your code. 


Available since: 4.1 
Return value 
Type: guint 


The micro version number of the WebKit library. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Functions 
Generated by[gi-docgen|2023.3 


Function 


WebKit2¢et_minor_version 


unstable since: 4.1 


Declaration 


guint 
webkit_get_minor_version ( 
void 


) 


Description 


Returns the minor version number of the WebKit library. 
(e.g. in WebKit version 1.8.3 this is 8.) 


This function is in the library, so it represents the WebKit library your code is running against. Contrast 
with the #WEBKIT_MINOR_VERSION macro, which represents the minor version of the WebKit 
headers you have included when compiling your code. 


Available since: 4.1 
Return value 
Type: guint 


The minor version number of the WebKit library. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Functions 
Generated by[gi-docgen|2023.3 


Function 


WebKit2media_key_system_permission_get_name 


since: 2.32 


Declaration 


const gchar* 
webkit_media_key_system_permission_get_name ( 
WebKitMediakeySystemPermissionRequest* request 


) 


Description 


Get the key system for which access permission is being requested. 


Available since: 2.32 


Parameters 


request 


Type: |WebKitMediakKeySystemPermissionRequest 


A WebKitMediakeySystemPermissionRequest. 


The data is owned by the caller of the function. 


Return value 
Type: const gchar* 
The key system name for request. 


The data is owned by the called function. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Functions 
Generated by[gi-docgen|2023.3 


Function 


WebKit2uri_for_display 


since: 2.24 


Declaration 


gchar* 
webkit_uri_for_display ( 
const gchar* uri 


) 


Description 


Use this function to format a URI for display. 


The URIs used internally by WebKit may contain percent-encoded characters or Punycode, which are not 
generally suitable to display to users. This function provides protection against IDN homograph attacks, so 
in some cases the host part of the returned URI may be in Punycode if the safety check fails. 


Available since: 2.24 
Parameters 
uri 
Type: const gchar* 
The URI to be converted. 


The data is owned by the caller of the function. 


The value is a NUL terminated UTF-8 string. 


Return value 
Type: gchar* 
uri suitable for display, or NULL in case of error. 
The caller of the function takes ownership of the data, and is responsible for freeing it. 


The return value can be NULL. 


The value is a NUL terminated UTF-8 string. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Functions 
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Function 


WebKit2user_media_permission_is_for_audio_device 


since: 2.8 


Declaration 


gboolean 
webkit_user_media_permission_is_for_audio_device ( 
WebKitUserMediaPermissionRequest* request 


) 


Description 


Check whether the permission request is for an audio device. 


Available since: 2.8 


Parameters 


request 


Type:|WebKitUserMediaPermissionRequest 


A WebKitUserMediaPermissionRequest. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE if access to an audio device was requested. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Functions 


Generated by[gi-docgen|2023.3 


Function 


WebKit2user_media_permission_is_for_display_device 


since: 2.34 


Declaration 


gboolean 
webkit_user_media_permission_is_for_display_device ( 
WebKitUserMediaPermissionRequest* request 


) 


Description 


Check whether the permission request is for a display device. 


Available since: 2.34 


Parameters 


request 


Type:|WebKitUserMediaPermissionRequest 


A WebKitUserMediaPermissionRequest. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE if access to a display device was requested. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Functions 


Generated by[gi-docgen|2023.3 


Function 


WebKit2user_media_permission_is_for_video_device 


since: 2.8 


Declaration 


gboolean 
webkit_user_media_permission_is_for_video_device ( 
WebKitUserMediaPermissionRequest* request 


) 


Description 


Check whether the permission request is for a video device. 


Available since: 2.8 


Parameters 


request 


Type:|WebKitUserMediaPermissionRequest 


A WebKitUserMediaPermissionRequest. 


The data is owned by the caller of the function. 


Return value 
Type: gboolean 


TRUE if access to a video device was requested. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Function Macros 
Generated by[gi-docgen|2023.3 


Function Macro 


WebKit2CHECK_VERSION 


unstable since: 4.1 


Declaration 


#define WEBKIT_CHECK_VERSION ( 
major, 
minor, 
micro 


) 


Description 


Check the version of the WebKit headers at compilation time. 
Available since: 4.1 

This function is not directly available to language bindings. 
Parameters 

major 


Type: - 


Major version (e.g. 1 for version 1.2.5) 


minor 


Type: — 


Minor version (e.g. 2 for version 1.2.5) 


micro 


Type: - 


Micro version (e.g. 5 for version 1.2.5) 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Function Macros 
Generated by[gi-docgen|2023.3 


Function Macro 


WebKit2DECLARE_TYPE 


unstable since: 4.1 


Declaration 


#define WEBKIT_DECLARE_TYPE ( 
ModuleObjName, 
module_obj_name, 

MODULE, 
OBJ_NAME, 
ParentName 


Description 


No description available. 
Available since: 4.1 
This function is not directly available to language bindings. 
Parameters 
ModuleOb Name 
Type: - 


No description available. 


module_obj_name 


Type: — 


No description available. 


MODULE 


Type: — 


No description available. 


OBJ_NAME 


Type: - 


No description available. 


ParentName 


Type: — 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Function Macros 
Generated by[gi-docgen|2023.3 


Function Macro 


WebKit2DEPRECATED_FOR 


unstable since: 4.1 


Declaration 


#define WEBKIT_DEPRECATED_FOR ( 
£ 
) 


Description 


Marks a symbol as deprecated, indicating a replacement. 
Available since: 4.1 
This function is not directly available to language bindings. 
Parameters 
£ 

Type: - 


Replacement symbol name. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Function Macros 
Generated by[gi-docgen|2023.3 


Function Macro 


WebKit2URI_REQUEST 


unstable since: 4.1 


Declaration 


#define WEBKIT_URI_REQUEST ( 
obj 
) 


Description 


No description available. 
Available since: 4.1 
This function is not directly available to language bindings. 
Parameters 
obj 
Type: - 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Function Macros 
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Function Macro 


WebKit2URI_REQUEST_CLASS 


unstable since: 4.1 


Declaration 


#define WEBKIT_URI_REQUEST_CLASS ( 
klass 
) 


Description 


No description available. 

Available since: 4.1 

This function is not directly available to language bindings. 
Parameters 

klass 


Type: - 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Function Macros 
Generated by[gi-docgen|2023.3 


Function Macro 


WebKit2URI_RESPONSE 


unstable since: 4.1 


Declaration 


#define WEBKIT_URI_RESPONSE ( 
obj 
) 


Description 


No description available. 
Available since: 4.1 
This function is not directly available to language bindings. 
Parameters 
obj 
Type: - 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Function Macros 
Generated by[gi-docgen|2023.3 


Function Macro 


WebKit2U0RI_RESPONSE_CLASS 


unstable since: 4.1 


Declaration 


#define WEBKIT_URI_RESPONSE_CLASS ( 
klass 
) 


Description 


No description available. 

Available since: 4.1 

This function is not directly available to language bindings. 
Parameters 

klass 


Type: - 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Function Macros 
Generated by[gi-docgen|2023.3 


Function Macro 


WebKit20RILSCHEME_REQUEST 


unstable since: 4.1 


Declaration 


#define WEBKIT_URI_SCHEME_REQUEST ( 
obj 
) 


Description 


No description available. 
Available since: 4.1 
This function is not directly available to language bindings. 
Parameters 
obj 
Type: - 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 
Function Macros 
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Function Macro 


WebKit2URISCHEME_REQUEST_CLASS 


unstable since: 4.1 


Declaration 


#define WEBKIT_URI_SCHEME_REQUEST_CLASS ( 
klass 
) 


Description 


No description available. 

Available since: 4.1 

This function is not directly available to language bindings. 
Parameters 

klass 


Type: - 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Function Macros 
Generated by[gi-docgen|2023.3 


Function Macro 


WebKit20URIL SCHEME RESPONSE 


unstable since: 4.1 


Declaration 


#define WEBKIT_URI_SCHEME_RESPONSE ( 
obj 
) 


Description 


No description available. 
Available since: 4.1 
This function is not directly available to language bindings. 
Parameters 
obj 
Type: - 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Function Macros 
Generated by[gi-docgen|2023.3 


Function Macro 


WebKit2URI SCHEME _RESPONSE_CLASS 


unstable since: 4.1 


Declaration 


#define WEBKIT_URI_SCHEME_RESPONSE_CLASS ( 
klass 
) 


Description 


No description available. 

Available since: 4.1 

This function is not directly available to language bindings. 
Parameters 

klass 


Type: - 


No description available. 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


EDITING_COMMAND_COPY 
Generated by[gi-docgen]2023.3 


Constant 


WebKit2EDITING_COMMAND_COPY 


unstable since: 4.1 


Declaration 


#define WEBKIT_EDITING_COMMAND_COPY "Copy" 


Description 


The copy clipboard command. Copies the current selection inside a WebKitWebView to the clipboard. 
You can check whether it’s possible to execute the command with 
webkit_web_view_can_execute_editing command(). In general it’s possible to copy to the clipboard 
when there is an active selection inside the WebKitWebView. 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


EDITING_COMMAND_CREATE_LINK 
Generated by[gi-docgen|2023.3 


Constant 


WebKit2EDITING_COMMAND_CREATE_LINK 


unstable since: 4.1 


Declaration 


#define WEBKIT_EDITING_COMMAND_CREATE_LINK "CreateLink" 


Description 


The create link command. Creates a link element that is inserted at the current cursor position. If there’s a 
selection, the selected text will be used as the link text, otherwise the URL itself will be used. It receives 
the link URL as argument. This command should be executed with 
webkit_web_view_execute_editing_command_with_argument () 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


IEDITING_COMMAND_CUT 
Generated by 2023.3 


Constant 


WebKit2EDITING_COMMAND_CUT 


unstable since: 4.1 


Declaration 


#define WEBKIT_EDITING_COMMAND_CUT "Cut" 


Description 


The cut clipboard command. Copies the current selection inside a WebKitWebView to the clipboard and 
deletes the selected content. You can check whether it’s possible to execute the command with 
webkit_web_view_can_execute_editing_command(). In general it’s possible to cut to the clipboard when 
the WebKitWebView content is editable and there is an active selection. 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


EDITING_COMMAND_INSERT_IMAGE 
Generated by[gi-docgen|2023.3 


Constant 


WebKit2EDITING_COMMAND_INSERT_IMAGE 


unstable since: 4.1 


Declaration 


#define WEBKIT_EDITING_COMMAND_INSERT_IMAGE "InsertImage" 


Description 


The insert image command. Creates an image element that is inserted at the current cursor position. It 
receives an URI as argument, that is used as the image source. This command should be executed 
with webkit_web_view_execute_editing_command_with_argument(). 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


EDITING_COMMAND_PASTE 
Generated by[gi-docgen|2023.3 


Constant 


WebKit2EDITING_COMMAND_PASTE 


unstable since: 4.1 


Declaration 


#define WEBKIT_EDITING_COMMAND_PASTE "Paste" 


Description 


The paste clipboard command. Pastes the contents of the clipboard to a WebKitWebView. You can 
check whether it’s possible to execute the command with 
webkit_web_view_can_execute_editing_command(). In general it’s possible to paste from the clipboard 
when the WebKitWebView content is editable and clipboard is not empty. 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


EDITING_COMMAND_PASTE_AS_PLAIN_TEXT 
Generated by[gi-docgen|2023.3 


Constant 


WebKit2EDITING_COMMAND_PASTE_AS_PLAIN_TEXT 


unstable since: 4.1 


Declaration 


#define WEBKIT_EDITING_COMMAND_PASTE_AS_PLAIN_TEXT "PasteAsPlainText" 


Description 


The paste as plaintext clipboard command. Pastes the contents of the clipboard to a WebKitWebView, 
with formatting removed. You can check whether it’s possible to execute the command with 
webkit_web_view_can_execute_editing_command(). In general it’s possible to paste from the clipboard 
when the WebKitWebView content is editable and clipboard is not empty. 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


EDITING_COMMAND_REDO 
Generated by[gi-docgen|2023.3 


Constant 


WebKit2EDITING_COMMAND_REDO 


unstable since: 4.1 


Declaration 


#define WEBKIT_EDITING_COMMAND_REDO "Redo" 


Description 


The redo command. Redoes a previously undone editing command in a WebKitWebView. You can 
check whether it’s possible to execute the command with 

webkit_web_view_can_execute_editing command(). It’s only possible to redo a command when it has 
been previously undone. 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


EDITING_COMMAND_SELECT_ALL 
Generated by[gi-docgen]2023.3 


Constant 


WebKit2EDITING_COMMAND_SELECT_ALL 


unstable since: 4.1 


Declaration 


#define WEBKIT_EDITING_COMMAND_SELECT_ALL "SelectAll" 


Description 


The select all command. Selects all the content of the current text field ina WebKitWebView. It is 
always possible to select all text, no matter whether the WebKitWebView content is editable or not. You 
can still check it with webkit_web_view_can_execute_editing command(). 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


EDITING_COMMAND_UNDO 
Generated by[gi-docgen]2023.3 


Constant 


WebKit2EDITING_COMMAND_UNDO 


unstable since: 4.1 


Declaration 


#define WEBKIT_EDITING_COMMAND_UNDO "Undo" 


Description 


The undo command. Undoes the last editing command in a WebKitWebView. You can check whether 
it’s possible to execute the command with webkit_web_view_can_execute_editing command(). It’s only 
possible to undo a command after a previously executed editing operation. 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


MAJOR_VERSION 
Generated by[gi-docgen|2023.3 


Constant 


WebKit2MAJOR_VERSION 


unstable since: 4.1 


Declaration 


#define WEBKIT_MAJOR_VERSION 2 


Description 


Like webkit_get_major_version(), but from the headers used at application compile time, rather than from 
the library linked against at application run time. 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


MICRO_VERSION 
Generated by[gi-docgen|2023.3 


Constant 


WebKit2MICRO_VERSION 


unstable since: 4.1 


Declaration 


#define WEBKIT_MICRO_VERSION 4 


Description 


Like webkit_get_micro_version(), but from the headers used at application compile time, rather than from 
the library linked against at application run time. 


Available since: 4.1 


| 


WebKit2 


API Version: 4.1 


Library Version: 2.42.4 


Constant 


MINOR_VERSION 
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Constant 


WebKit2MINOR_VERSION 


unstable since: 4.1 


Declaration 


#define WEBKIT_MINOR_VERSION 42 


Description 


Like webkit_get_minor_version(), but from the headers used at application compile time, rather than from 
the library linked against at application run time. 


Available since: 4.1 


